Import-AipServiceTpd

  • 참조
모듈:
AIPService

Azure Information Protection 대한 AD RMS에서 TPD를 가져옵니다.

Syntax

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

Description

Import-AipServiceTpd cmdlet은 인터넷을 통해 AD RMS(Active Directory Rights Management Services) TPD(신뢰할 수 있는 게시 도메인)를 Azure Information Protection 대한 테넌트로 가져오므로 온-프레미스에서 클라우드로 보호 서비스를 마이그레이션할 수 있습니다. TPD에는 AD RMS의 프라이빗 키 및 보호 템플릿이 포함되어 있습니다.

PowerShell을 사용하여 테넌트 키를 구성해야 합니다. 관리 포털을 사용하여 이 구성을 수행할 수 없습니다.

이 cmdlet은 항상 가져온 TPD에서 보관된 상태로 키를 설정합니다. 이 명령을 실행하면 가져온 TPD의 키를 Azure Information Protection 사용하여 AD RMS가 이 키를 사용하여 보호하는 콘텐츠를 사용할 수 있게 됩니다. Set-AipServiceKeyProperties cmdlet을 사용하여 가져온 TPD의 상태를 활성으로 변경합니다.

경고

AD RMS에서 마이그레이션의 요구 사항, 제한 사항, 지침 및 의미를 읽고 이해하지 않는 한 이 cmdlet을 실행하지 마세요.

자세한 내용은 AD RMS에서 Azure Information Protection으로 마이그레이션을 참조하세요.

AD RMS에서 템플릿을 활성으로 마이그레이션하는 경우 Azure Portal 또는 PowerShell을 사용하여 이러한 템플릿을 편집할 수 있습니다. 사용자가 애플리케이션에서 선택할 수 있도록 이러한 템플릿을 게시할 수 있습니다. 마이그레이션된 템플릿이 활성화되지 않으면 이전에 보호했던 문서를 여는 데만 사용할 수 있습니다.

AD RMS 관리 콘솔을 사용하여 TPD를 내보내야 합니다. 키에 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 cmdlet을 사용하여 암호를 보안 문자열로 만든 다음 $Password 변수에 보안 문자열을 저장합니다. 자세한 내용을 보려면 Get-Help Read-Host를 입력하십시오.

두 번째 명령은 소프트웨어 키와 함께 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 변수에 보안 문자열을 저장합니다.

두 번째 명령은 Azure Key Vault 저장된 키와 함께 사용할 TPD를 가져옵니다. 또한 명령은 키의 이름을 "Contoso BYOK 키"로 변경합니다.

이 예제에서는 contoso-byok-kv의 키 자격 증명 모음 이름, contosoaipservice-byok의 키 이름 및 aaaabbbbcccc1111122223333의 버전 번호를 사용합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FriendlyName

AD RMS에서 가져온 TPD(신뢰할 수 있는 게시 도메인) 및 SLC 키의 이름을 지정합니다. 사용자가 Office 2016 또는 Office 2013을 실행하는 경우 서버 인증서 탭에서 AD RMS 클러스터 속성에 대해 설정된 것과 동일한 이름 값을 지정합니다.

이 매개 변수는 선택 사항입니다. 사용하지 않으면 키 식별자가 대신 사용됩니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-KeyVaultKeyUrl

테넌트 키에 사용할 Azure Key Vault 키의 URL을 지정합니다. 이 키는 Azure Information Protection 테넌트에 대한 모든 암호화 작업의 루트 키로 사용됩니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProtectionPassword

내보낸 TPD 파일을 암호화하는 데 사용한 암호를 지정합니다.

ConvertTo-SecureString -AsPlaintext 또는 Read-Host를 사용하여 SecureString을 지정할 수 있습니다.

ConvertTo-SecureString을 사용하고 암호에 특수 문자가 있는 경우 큰따옴표 사이에 암호를 입력하거나 특수 문자를 이스케이프합니다. 그렇지 않으면 암호가 올바르게 구문 분석되지 않으며 자세한 정보 표시 모드에서는 다음과 같은 오류 메시지가 표시됩니다.

VERBOSE: 신뢰할 수 있는 게시 도메인 데이터가 손상되었습니다.VERBOSE: 원격 서버가 예기치 않은 응답((400) 잘못된 요청을 반환했습니다.

예를 들어 암호가 Pa$$word 경우 Windows PowerShell 특수 문자를 올바르게 구문 분석할 수 있도록 'Pa$$word' 또는 Pa'$'$word 입력합니다. 전체 예제에서는 $pwd = ConvertTo-SecureString 'Pa$$w 0rd' -AsPlainText -Force 를 입력한 다음 저장된 값이 올바른지 확인하려면 $pwd 입력하여 Pa$$word 표시되는지 확인할 수 있습니다.

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TpdFile

Azure Information Protection 사용할 테넌트로 가져오기 위해 AD RMS 클러스터에서 내보낸 TPD 파일을 지정합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False