次の方法で共有


New-DataEncryptionPolicy

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Exchange Onlineでデータ暗号化ポリシーを作成するには、New-DataEncryptionPolicy コマンドレットを使用します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Default (既定)

New-DataEncryptionPolicy
    [-Name] <String>
    -AzureKeyIDs <MultiValuedProperty>
    [-Confirm]
    [-Description <String>]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

説明

データ暗号化ポリシー コマンドレットは、Customer Key のExchange Online部分です。 詳細については、「 カスタマー キーを使用した Microsoft 365 でのデータの制御」を参照してください。

PowerShell の Set-Mailbox コマンドレットで DataEncryptionPolicy パラメーターを使用して、データ暗号化ポリシーをメールボックスExchange Online割り当てることができます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例 1

New-DataEncryptionPolicy -Name "US Mailboxes" -AzureKeyIDs "https://contosoWestUSvault01.vault.azure.net/keys/USA_Key_01","https://contosoEastUSvault01.vault.azure.net/keys/USA_Key_02" -Description "Root key for mailboxes located in US territories"

この例では、指定された Azure Key Vault キーと説明を使用して、US Mailboxes という名前のデータ暗号化ポリシーを作成します。

パラメーター

-AzureKeyIDs

適用対象: Exchange Online

AzureKeyIDs パラメーターは、データ暗号化ポリシーに関連付ける Azure Key Vault キーの URI 値を指定します。 少なくとも 2 つの Azure Key Vault キーをコンマで区切って指定する必要があります。 たとえば、「 "https://contosoWestUSvault01.vault.azure.net/keys/USA_Key_01","https://contosoEastUSvault01.vault.azure.net/keys/USA_Key_02" 」のように入力します。

Azure Key Vaultの URI 値を見つけるには、<VaultName> をコンテナーの名前に置き換え、Azure Rights Management PowerShell: Get-AzureKeyVaultKey -VaultName <VaultName>).id で次のコマンドを実行します。 詳細については、「Azure Key Vaultについて」を参照してください。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

適用対象: Exchange Online

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Description

適用対象: Exchange Online

Description パラメーターは、データの暗号化ポリシーの省略可能な説明を指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DomainController

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Enabled

適用対象: Exchange Online

Enabled パラメーターは、データ暗号化ポリシーを有効または無効にします。 有効な値は次のとおりです。

  • $true: ポリシーを有効にします。 この値が既定値です。
  • $true: ポリシーを有効にします。これが既定値です。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

適用対象: Exchange Online

Name パラメーターは、データの暗号化ポリシーの一意の名前を指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

適用対象: Exchange Online

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。