Import-AipServiceTpd

構文

Import-AipServiceTpd
      [-Force]
      -TpdFile <String>
      -ProtectionPassword <SecureString>
      [-FriendlyName <String>]
      [-KeyVaultKeyUrl <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Import-AipServiceTpd コマンドレットは、オンプレミスからクラウドに保護サービスを移行できるように、インターネット経由で Active Directory Rights Management Services (AD RMS) の信頼された発行ドメイン (TPD) を Azure Information Protection のテナントにインポートします。 TPD には、AD RMS の秘密キーと保護テンプレートが含まれています。

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

このコマンドレットは、インポートされた TPD のキーを常にアーカイブ状態に設定します。 このコマンドを実行すると、インポートされた TPD 内のキーが Azure Information Protection で使用できるようになり、このキーを使用して AD RMS によって保護されたコンテンツが使用できるようになります。 Set-AipServiceKeyProperties コマンドレットを使用して、インポートされた TPD の状態をアクティブに変更します。

AD RMS からテンプレートをアクティブとして移行する場合は、Azure portal または PowerShell を使用して、これらのテンプレートを編集できます。 ユーザーがアプリケーションからテンプレートを選択できるように、これらのテンプレートを発行できます。 移行されたテンプレートがアクティブ化されていない場合は、以前に保護されていたドキュメントを開くためにのみ使用できます。

TPD をエクスポートするには、AD RMS 管理コンソールを使用する必要があります。 キーにハードウェア セキュリティ モジュール (HSM) を使用する場合は、まず Azure Key Vault BYOK ツールを使用して TPD キーを再パッケージ化する必要があります。 詳細については、「Azure Key Vaultの HSM で保護されたキーを生成および転送する方法」を参照してください。

例

例 1: ソフトウェア キーを使用して TPD をインポートする

PS C:\>$Password = Read-Host -AsSecureString -Prompt "Password: "
PS C:\> Import-AipServiceTpd -TpdFile "C:\aipservice_tpd.xml" -ProtectionPassword $Password -Verbose

最初のコマンドは、Read-Host コマンドレットを使用してセキュリティで保護された文字列としてパスワードを作成し、その後、セキュリティで保護された文字列を$Password変数に格納します。 詳細については、「Get-Help Read-Host」と入力します。

2 番目のコマンドは、ソフトウェア キーを使用して TPD をインポートします。

例 2: HSM キーを使用して TPD をインポートする

PS C:\>$Password = Read-Host -AsSecureString -Prompt "Password: "
PS C:\> Import-AipServiceTpd -TpdFile "C:\no_key_tpd.xml" -ProtectionPassword $Password -KeyVaultKeyUrl "https://contoso-byok-kv.vault.azure.net/keys/contosoaipservice-byok/aaaabbbbcccc111122223333" -FriendlyName "Contoso BYOK key" -Verbose

最初のコマンドは、セキュリティで保護された文字列としてパスワードを作成し、セキュリティで保護された文字列を $Password 変数に格納します。

2 番目のコマンドは、Azure Key Vault に格納されているキーと共に使用する TPD をインポートします。 さらに、このコマンドにより、キーのフレンドリ名が "Contoso BYOK キー"に変更されます。

この例では、contoso-byok-kvのキー コンテナー名、contosoaipservice-byokのキー名、および aaaabbbbcccc1111112223333のバージョン番号 使用します。

パラメーター

-Confirm

-Force

-FriendlyName

-KeyVaultKeyUrl

-ProtectionPassword

-TpdFile

-WhatIf

関連リンク

• Set-AipServiceKeyProperties
• AD RMS から Azure Information Protection への移行
• Azure Key Vault の HSM で保護されたキーを生成して転送する方法