AIPService PowerShell 모듈 설치

:Azure Information Protection,Office 365

관련성: AIP 통합 레이블링 클라이언트 및 클래식 클라이언트

참고 사항

통합되고 간소화된 고객 환경을 제공하기 위해 Azure Portal의 Azure Information Protection 클래식 클라이언트 및 레이블 관리는 2021년 3월 31일현재 사용되지 않습니다. 클래식 클라이언트에 대한 추가 지원은 제공되지 않고 유지 관리 버전은 더 이상 릴리스되지 않습니다.

클래식 클라이언트는 공식적으로 사용 중지되어 2022년 3월 31일 작동이 중지됩니다.

현재 모든 Azure Information Protection 클래식 클라이언트 고객은 통합 레이블 Microsoft Information Protection 플랫폼으로 마이그레이션하고 통합 레이블링 클라이언트로 업그레이드해야 합니다. 마이그레이션 블로그 에서자세히 알아보기

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

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

전제요소

이 표에는 Azure Information Protection의 보호 서비스에 대한 AIPService PowerShell 모듈을 설치하고 사용하는 데 필요한 구성이 나열됩니다.

요구 사항 자세한 정보
최소 버전 Windows PowerShell 버전 3.0

PowerShell 세션을 입력하여 실행 중인 Windows PowerShell 버전을 $PSVersionTable 확인할 수 있습니다. 이후 버전의 버전을 설치해야 하는 Windows PowerShell 기존 버전 업그레이드를 Windows PowerShell.
Microsoft 소프트웨어의 최소 .NET Framework 버전 4.5

참고: 이 Microsoft .NET Framework 버전은 이후 운영 체제에 포함되어 있으므로 클라이언트 운영 체제가 Windows 8.0보다 작거나 서버 운영 체제가 Windows Server 2012.

Microsoft .NET Framework 버전이 아직 설치되어 있지 않은 경우 Microsoft .NET Framework 4.5 를 다운로드할수 있습니다. 이 최소 버전의 Microsoft .NET Framework AIPService 모듈이 사용하는 일부 클래스에 필요합니다.
필수 라이선스 이 기능을 사용하려면 제품 라이선스가 있어야 합니다. 자세한 내용은 보안 준수에 Microsoft 365 라이선스 지침 - 서비스 설명 을 참조하세요.

AADRM 모듈이 설치되어 있는 경우

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

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

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

Uninstall-Module -Name AADRM

Azure 권한 관리 관리 도구로 AADRM 모듈을 설치한 경우 프로그램 및 기능을 사용하여 Azure AD rights Management 관리 Windows 제거합니다.

AIPService 모듈을 설치하는 방법

AIPService 모듈은 PowerShell 갤러리에 있으며 Microsoft 다운로드 센터에서 사용할 수 없습니다.

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

명령을 사용하여 특정 cmdlet에 대한 도움말을 보고 -online 매개 변수를 사용하여 Microsoft 설명서 사이트에서 최신 Get-Help <cmdlet_name> 도움말을 볼 수 있습니다. Get-Help <cmdlet_name> 예를 들어:

Get-Help Connect-AipService -online

자세한 내용은

  • 사용 가능한 cmdlet의 전체 목록: AIPService 모듈

  • PowerShell을 지원하는 기본 구성 시나리오 목록: PowerShell을 사용하여 Azure Information Protection에서 보호 관리

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

구성 명령 실행을 완료한 경우 모범 사례로 연결 끊기-AipService cmdlet을 사용하여 서비스 연결을 끊습니다. 연결이 끊어지지 않은 경우 비활성 기간 후에 연결이 자동으로 끊어집니다. 자동 연결 끊기 동작 때문에 PowerShell 세션에서 가끔 다시 연결해야 하는 경우도 있습니다.

참고 사항

보호 서비스가 아직 활성화되지 않은 경우 Enable-AipService cmdlet을 사용하여 서비스에 연결한 후 이 작업을 할 수 있습니다.