다음 정보를 사용하여 Microsoft Purview Information Protection Azure Right Management 암호화 서비스에 대한 Windows PowerShell 모듈을 설치할 수 있습니다. 이 모듈의 이름은 AIPService이며 AADRM이라는 이전 버전을 대체합니다.
이 PowerShell 모듈을 사용하여 인터넷 연결이 있고 다음 섹션에 나열된 필수 구성 요소를 충족하는 모든 Windows 컴퓨터를 사용하여 명령줄에서 Azure Rights Management 암호화 서비스를 관리할 수 있습니다. Azure Rights Management용 Windows PowerShell 자동화를 위한 스크립팅을 지원하거나 고급 구성 시나리오에 필요할 수 있습니다. 모듈에서 지원하는 관리 작업 및 구성에 대한 자세한 내용은 PowerShell을 사용하여 Azure Rights Management 서비스 관리를 참조하세요.
필수 구성 요소
이 표에는 Azure Rights Management 암호화 서비스에 AIPService PowerShell 모듈을 설치하고 사용하기 위한 필수 구성 요소가 나와 있습니다.
| 요구 사항 | 자세한 정보 |
|---|---|
| 최소 버전의 Windows PowerShell | 버전 3.0 PowerShell 세션을 입력하여 $PSVersionTable 실행 중인 Windows PowerShell 버전을 확인할 수 있습니다. 이후 버전의 Windows PowerShell 설치해야 하는 경우 기존 Windows PowerShell 업그레이드를 참조하세요. AIPService PowerShell 모듈은 Windows PowerShell만 지원합니다. PowerShell 7은 지원되지 않습니다. |
| Microsoft .NET Framework 최소 버전 | 버전 4.8 이 Microsoft .NET Framework 최소 버전은 이후 운영 체제에 포함되어 있지만 아직 설치되지 않은 경우 Microsoft .NET Framework 4.8을 다운로드할 수 있습니다. 이 Microsoft .NET Framework 최소 버전은 AIPService 모듈에서 사용하는 일부 클래스에 필요합니다. |
| 필수 라이선스 | 이 기능을 사용하려면 제품 라이선스가 있어야 합니다. 자세한 내용은 보안 & 규정 준수에 대한 Microsoft 365 라이선스 지침 - 서비스 설명을 참조하세요. |
AADRM 모듈이 설치된 경우
AIPService 모듈은 이전 모듈인 AADRM을 대체합니다. 이전 모듈을 설치한 경우 제거한 다음 AIPService 모듈을 설치합니다.
최신 모듈에는 기존 스크립트가 계속 작동하도록 이전 모듈의 cmdlet 이름에 별칭이 있습니다. 이전 모듈은 2020년 7월 15일 지원에서 제외됩니다.
PowerShell 갤러리 AADRM 모듈을 설치한 경우 제거하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell 세션을 시작하고 다음을 입력합니다.
Uninstall-Module -Name AADRM
Azure Rights Management 관리 도구를 사용하여 AADRM 모듈을 설치한 경우 Windows 제거 애플리케이션 프로시저를 사용하여 Windows Azure AD Rights Management 관리를 제거합니다.
AIPService 모듈을 설치하는 방법
AIPService 모듈은 PowerShell 갤러리 있으며 Microsoft 다운로드 센터에서 사용할 수 없습니다.
PowerShell 갤러리 AIPService 모듈을 설치하려면
PowerShell 갤러리 익숙하지 않은 경우 PowerShell 갤러리 시작을 참조하세요. PowerShellGet 모듈 및 NuGet 공급자 설치를 포함하는 갤러리 요구 사항에 대한 지침을 따릅니다.
PowerShell 갤러리 AIPService 모듈에 대한 세부 정보를 보려면 AIPService 페이지를 방문하세요.
AIPService 모듈을 설치하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell 세션을 시작하고 다음을 입력합니다.
Install-Module -Name AIPService
신뢰할 수 없는 리포지토리에서 설치하라는 경고가 표시되면 Y를 눌러 확인할 수 있습니다. 또는 N 키를 누르고 명령을 사용하여 PowerShell 갤러리 신뢰할 수 있는 리포지토리로 구성한 다음, 명령을 Set-PSRepository -Name PSGallery -InstallationPolicy Trusted 다시 실행하여 AIPService 모듈을 설치합니다.
갤러리에서 이전 버전의 AIPService 모듈을 설치한 경우 다음을 입력하여 최신 버전으로 업데이트합니다.
Update-Module -Name AIPService
다음 단계
Windows PowerShell 세션에서 설치된 모듈의 버전을 확인합니다. 이전 버전에서 업그레이드한 경우 이 검사 특히 중요합니다.
(Get-Module AIPService –ListAvailable).Version
참고
이 명령이 실패하면 먼저 Import-Module AIPService를 실행합니다.
사용할 수 있는 cmdlet을 확인하려면 다음을 입력합니다.
Get-Command -Module AIPService
Get-Help <cmdlet_name> 명령을 사용하여 특정 cmdlet에 대한 도움말을 확인하고 -online 매개 변수를 사용하여 Microsoft 설명서 사이트에서 최신 도움말을 확인합니다. 예시:
Get-Help Connect-AipService -online
자세한 내용은 다음을 참조하세요.
사용 가능한 cmdlet의 전체 목록: AIPService 모듈
PowerShell을 지원하는 주요 구성 시나리오 목록: PowerShell을 사용하여 Azure Rights Management 서비스 관리
Azure Rights Management 서비스를 구성하는 명령을 실행하려면 먼저 Connect-AipService cmdlet을 사용하여 서비스에 연결해야 합니다.
구성 명령 실행을 완료한 경우 모범 사례로 Disconnect-AipService cmdlet을 사용하여 서비스에서 연결을 끊습니다. 연결을 끊지 않으면 비활성 기간이 지나면 연결이 자동으로 끊어집니다. 자동 연결 끊김 동작으로 인해 PowerShell 세션에서 가끔 다시 연결해야 할 수 있습니다.
참고
Azure Rights Management 서비스가 아직 활성화되지 않은 경우 Enable-AipService cmdlet을 사용하여 서비스에 연결한 후에 이 작업을 수행할 수 있습니다.