Use-AipServiceKeyVaultKey

構文

Use-AipServiceKeyVaultKey
   -KeyVaultKeyUrl <String>
   [-FriendlyName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Use-AipServiceKeyVaultKey コマンドレットは、Azure Key Vault でカスタマー マネージド キー (BYOK) を使用するように Azure Information Protection に指示します。

PowerShell を使用してテナント キーを構成する必要があります。管理ポータルを使用してこの構成を行うことはできません。

このコマンドレットは、保護サービス (Azure Rights Management) がアクティブ化される前または後に実行できます。

このコマンドレットを実行する前に、Azure Information Protection に使用するキーを含むキー コンテナーに対するアクセス許可が Azure Rights Management サービス プリンシパルに付与されていることを確認します。 これらのアクセス許可は、Set-AzKeyVaultAccessPolicyAzure Key Vault コマンドレットを実行することによって付与されます。

セキュリティ上の理由から、Use-AipServiceKeyVaultKey コマンドレット では、Azure Key Vault のキーのアクセス制御を設定または変更することはできません。 Set-AzKeyVaultAccessPolicy実行してアクセス権が付与されたら、Use-AipServiceKeyVaultKey 実行して、KeyVaultKeyUrl パラメーターで指定したキーとバージョンを使用するように Azure Information Protection に指示します。

詳細については、「Azure Key Vault の場所を選択するためのベスト プラクティス」を参照してください。

コマンドが正常に実行されると、組織の Azure Information Protection のアーカイブされたカスタマー マネージド テナント キーとしてキーが追加されます。 Azure Information Protection のアクティブなテナント キーにするには、Set-AipServiceKeyProperties コマンドレットを実行する必要があります。

Azure Key Vault を使用して、指定したキーの使用を一元的に管理および監視します。 テナント キーに対するすべての呼び出しは、組織が所有するキー コンテナーに対して行われます。 Get-AipServiceKeys コマンドレットを使用して、Key Vault で使用しているキーを確認できます。

Azure Information Protection でサポートされるテナント キーの種類の詳細については、「Azure Information Protection テナント キーの計画と実装」を参照してください。

Azure Key Vault の詳細については、「Azure Key Vaultとは」を参照してください。

例

例 1: Azure Key Vault でカスタマー マネージド キーを使用するように Azure Information Protection を構成する

PS C:\>Use-AipServiceKeyVaultKey -KeyVaultKeyUrl "https://contoso.vault.azure.net/keys/contoso-aipservice-key/aaaabbbbcccc111122223333"

このコマンドは、contoso-aipservice-key、バージョン aaaabbbbcccc1111122223333contosoという名前のキー コンテナー 使用するように Azure Information Protection に指示します。

Azure Key Vault のこのキーとバージョンは、Azure Information Protection のカスタマー マネージド テナント キーになります。

パラメーター

-Confirm

-Force

-FriendlyName

-KeyVaultKeyUrl

-WhatIf

関連リンク

• Get-AipServiceKeys
• Set-AipServiceKeyProperties