Import-AipServiceTpd

Syntax

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

Description

Cmdleten Import-AipServiceTpd importerar en betrodd publiceringsdomän för Active Directory Rights Management Services (AD RMS) via Internet till din klientorganisation för Azure Information Protection, så att du kan migrera din skyddstjänst från en lokal plats till molnet. TPD innehåller din privata nyckel och skyddsmallar från AD RMS.

Du måste använda PowerShell för att konfigurera klientnyckeln. du kan inte göra den här konfigurationen med hjälp av en hanteringsportal.

Den här cmdleten anger alltid nyckeln från den importerade TPD:en till ett arkiverat tillstånd. När du har kört det här kommandot blir nyckeln i den importerade TPD:en tillgänglig för Azure Information Protection för att använda innehåll som AD RMS skyddas med hjälp av den här nyckeln. Använd cmdleten Set-AipServiceKeyProperties för att ändra tillståndet för den importerade TPD:en till Aktiv.

Om du migrerar mallar från AD RMS som aktiva kan du redigera dessa mallar i Azure Portal eller med hjälp av PowerShell. Du kan publicera dessa mallar så att användarna kan välja dem från program. Om de migrerade mallarna inte aktiveras kan de bara användas för att öppna dokument som de tidigare skyddade.

Du måste använda AD RMS-hanteringskonsolen för att exportera TPD. Om du använder en maskinvarusäkerhetsmodul (HSM) för dina nycklar måste du först paketera om TPD-nycklarna med hjälp av Azure Key Vault BYOK-verktyg. Du kan ladda ned dessa verktyg från Microsoft Download Site.

Mer information finns i Så här genererar och överför du HSM-skyddade nycklar för Azure Key Vault.

Exempel

Exempel 1: Importera TPD med en programvarunyckel

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

Det första kommandot skapar ett lösenord som en säker sträng med hjälp av cmdleten Read-Host och lagrar sedan den säkra strängen i variabeln $Password. För mer information ange Get-Help Read-Host.

Det andra kommandot importerar en TPD med en programvarunyckel.

Exempel 2: Importera TPD med en HSM-nyckel

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

Det första kommandot skapar ett lösenord som en säker sträng och lagrar sedan den säkra strängen i variabeln $Password .

Det andra kommandot importerar en TPD som ska användas med en nyckel som lagras i Azure Key Vault. Dessutom ändrar kommandot det egna namnet på nyckeln till "Contoso BYOK-nyckel".

I vårt exempel används nyckelvalvets namn contoso-byok-kv, nyckelnamnet contosoaipservice-byok och versionsnumret för aaaabbbbcccc111122223333.

Parametrar

-Confirm

-Force

-FriendlyName

-KeyVaultKeyUrl

-ProtectionPassword

-TpdFile

-WhatIf

Relaterade länkar

• Set-AipServiceKeyProperties
• Migrera från AD RMS till Azure Information Protection
• Generera och överföra HSM-skyddade nycklar för Azure Key Vault