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 キーを再パッケージ化する必要があります。 これらのツールは 、Microsoft ダウンロード サイトからダウンロードできます。

詳細については、「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 のキー名、 aaaabbbbcccc1111122223333 のバージョン番号を使用します。

パラメーター

-Confirm

-Force

-FriendlyName

-KeyVaultKeyUrl

-ProtectionPassword

-TpdFile

-WhatIf

関連リンク

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