AIPService PowerShell 모듈 설치

아티클
07/11/2023

다음 정보는 Azure Information Protection에서 보호 서비스에 대한 Windows PowerShell 모듈을 설치하는 데 도움이 됩니다. 이 모듈의 이름은 AIPService이며, AADRM이라는 이전 버전을 대체합니다.

인터넷에 연결되어 있고 다음 섹션에 나열된 필수 구성 요소를 충족하는 Windows 컴퓨터를 사용하여 명령줄에서 보호 서비스(Azure Rights Management)를 관리하는 데 이 PowerShell 모듈을 사용할 수 있습니다. Azure Information Protection용 Windows PowerShell은 자동화용 스크립팅을 지원하거나 고급 구성 시나리오에 필요할 수 있습니다. 모듈에서 지원하는 관리 작업 및 구성에 대한 자세한 내용은 PowerShell을 사용하여 Azure Information Protection에서 보호 관리를 참조하세요.

필수 조건

다음 표에는 Azure Information Protection에서 보호 서비스에 대한 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는 최신 운영 체제에 포함되어 있으므로 클라이언트 운영 체제가 Windows 8.0보다 낮거나 서버 운영 체제가 Windows Server 2012보다 낮은 경우에만 수동으로 설치해야 합니다. Microsoft .NET Framework의 최소 버전이 아직 설치되지 않은 경우 Microsoft .NET Framework 4.8을 다운로드할 수 있습니다. AIPService 관리 모듈이 사용하는 일부 클래스에는 이 Microsoft .NET Framework의 최소 버전이 필요합니다.
필수 라이선스	이 기능을 사용하려면 제품 라이선스가 있어야 합니다. 자세한 내용은 보안 및 규정 준수 - 서비스 설명에 대한 Microsoft 365 라이선스 지침을 참조 하세요.

AADRM 모듈이 설치된 경우

AIPService 모듈은 이전 모듈인 AADRM을 대체합니다. 이전 모듈을 설치한 경우 제거한 다음 AIPService 모듈을 설치합니다.

최신 모듈에는 기존 스크립트가 계속 작동하도록 이전 모듈의 cmdlet 이름에 대한 별칭이 있습니다. 그러나 이전 모듈의 지원이 종료되기 전에 이러한 참조를 업데이트하려고 합니다. AADRM 모듈에 대한 지원은 2020년 7월 15일에 종료됩니다.

PowerShell 갤러리에서 설치한 AADRM 모듈을 제거하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell 세션을 시작하고 다음을 입력합니다.

Uninstall-Module -Name AADRM

Azure 권한 관리 관리 도구로 AADRM 모듈을 설치한 경우 프로그램 및 기능을 사용하여 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을 누르고 Set-PSRepository -Name PSGallery -InstallationPolicy Trusted 명령을 사용하여 신뢰할 수 있는 리포지토리로 PowerShell 갤러리를 구성한 다음 이 명령을 다시 실행하여 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 Information Protection에서 보호 관리

보호 서비스를 구성하는 명령을 실행하려면 먼저 Connect-AipService cmdlet을 사용하여 서비스에 연결해야 합니다.

구성 명령을 실행했으면 Disconnect-AipService cmdlet을 사용하여 서비스에서 연결을 끊습니다. 연결을 끊지 않으면 비활성 기간이 지나면 연결이 자동으로 끊어집니다. 자동 연결 끊김 동작으로 인해 PowerShell 세션에서 가끔 다시 연결해야 할 수 있습니다.