AADRM PowerShell 모듈 설치Installing the AADRM PowerShell module

적용 대상: Azure Information Protection, Office 365Applies to: Azure Information Protection, Office 365

다음 정보를 통해 Azure Information Protection의 Azure Rights Management 서비스에 대한 Windows PowerShell 모듈을 설치할 수 있습니다.Use the following information to help you install the Windows PowerShell module for the Azure Rights Management service from Azure Information Protection. 이 모듈의 이름은 AADRM입니다.The name of this module is AADRM.

인터넷에 연결되어 있고 다음 섹션에 나열된 필수 구성 요소를 충족하는 컴퓨터를 사용하여 명령줄에서 Azure Rights Management 서비스를 관리하는 데 이 PowerShell 모듈을 사용할 수 있습니다.You can use this PowerShell module to administer the Azure Rights Management service from the command line by using any computer that has an Internet connection and that meets the prerequisites listed in the next section. Azure Rights ManagementAzure Rights Management용 Windows PowerShell은 자동화용 스크립팅을 지원하거나 고급 구성 시나리오에 필요할 수 있습니다.Windows PowerShell for Azure Rights ManagementAzure Rights Management supports scripting for automation or might be necessary for advanced configuration scenarios. 모듈에서 지원하는 관리 작업 및 구성에 대한 자세한 내용은 Windows PowerShell을 사용하여 Azure 권한 관리 관리를 참조하세요.For more information about the administration tasks and configurations that the module supports, see Administering Azure Rights Management by Using Windows PowerShell.

전제 조건Prerequisites

이 테이블에는 Azure Information Protection의 Azure Rights Management 서비스에 AADRM PowerShell 모듈을 설치하고 사용하기 위한 필수 구성 요소를 포함합니다.This table lists the prerequisites to install and use the AADRM PowerShell module for the Azure Rights Management service from Azure Information Protection.

요구 사항Requirement 추가 정보More information
최소 Windows PowerShell 버전: 3.0Minimum version of Windows PowerShell: 3.0 PowerShell 세션에서 $PSVersionTable을 입력하면 실행 중인 Windows PowerShell 버전을 확인할 수 있습니다.You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a PowerShell session.

Windows PowerShell의 최신 버전을 설치해야 할 경우 기존 Windows PowerShell 업그레이드를 참조하세요.If you need to install a later version of Windows PowerShell, see Upgrading existing Windows PowerShell.
최소 Microsoft .NET Framework 버전: 4.5Minimum version of the Microsoft .NET Framework: 4.5

참고: 이 버전의 Microsoft .NET Framework는 최신 운영 체제에 포함되어 있으므로 클라이언트 운영 체제가 Windows 8.0보다 낮거나 서버 운영 체제가 Windows Server 2012보다 낮은 경우에만 수동으로 설치해야 합니다.Note: This version of the Microsoft .NET Framework is included with the later operating systems, so you should need to manually install it only if your client operating system is less than Windows 8.0 or your server operating system is less than Windows Server 2012.
Microsoft .NET Framework의 최소 버전을 아직 설치하지 않은 경우 Microsoft .NET Framework 4.5를 다운로드할 수 있습니다.If the minimum version of the Microsoft .NET Framework is not already installed, you can download Microsoft .NET Framework 4.5.

AADRM 모듈이 사용하는 일부 클래스에는 이 Mrciosoft .NET Framework의 최소 버전이 필요합니다.This minimum version of the Microsoft .NET Framework is required for some of the classes that the AADRM module uses.

AADRM 모듈의 2.5.0.0 버전부터는 Microsoft Online Services 로그인 도우미가 더 이상 필요하지 않습니다.Starting with version 2.5.0.0 of the AADRM module, the Microsoft Online Services Sign-In Assistant is no longer required.

참고

Azure Rights Management 관리 도구와 함께 AADRM 모듈 버전을 설치한 경우 프로그램 및 기능을 사용하여 Microsoft Azure AD Rights Management 관리를 제거한 후 PowerShell 갤러리에서 최신 버전의 AADRM 모듈을 설치합니다.If you installed a version of the AADRM module with the Azure Rights Management Administration Tool, use Programs and Features to uninstall Windows Azure AD Rights Management Administration before you install the latest version of the AADRM module from the PowerShell Gallery.

AADRM 모듈를 설치하는 방법How to install the AADRM module

AADRM 모듈이 PowerShell 갤러리로 이동했고 Microsoft 다운로드 센터에서 더 이상 제공되지 않습니다.The AADRM module has moved to the PowerShell Gallery and is no longer available from the Microsoft Download Center.

PowerShell 갤러리를 처음 사용하는 경우 PowerShell 갤러리 시작을 참조하세요.If you're new to the PowerShell Gallery, see Get Started with the PowerShell Gallery. PowerShellGet 모듈 및 NuGet 공급자 설치를 포함하여 갤러리 요구 사항에 대한 지침을 따릅니다.Follow the instructions for the gallery requirements, which include installing the PowerShellGet module and the NuGet provider.

PowerShell 갤러리에서 AADRM 모듈에 대한 세부 정보를 보려면 AADRM 페이지를 방문하세요.To see details about the AADRM module on the PowerShell Gallery, visit the AADRM page.

AADRM 모듈을 설치하려면 관리자 권한으로 실행 옵션으로 PowerShell 세션을 시작하고 다음을 입력합니다.To install the AADRM module, start a PowerShell session with the Run as Administrator option, and type:

Install-Module -Name AADRM

신뢰할 수 없는 리포지토리에서 설치하는 경우에 대한 경고가 표시되면 Y 키를 눌러 확인하면 됩니다.If you are warned about installing from an untrusted repository, you can press Y to confirm. 또는 N 키를 누르고 Set-PSRepository -Name PSGallery -InstallationPolicy Trusted 명령을 사용하여 PowerShell 갤러리를 신뢰할 수 있는 리포지토리로 구성한 다음, 명령을 다시 실행하여 AADRM 모듈을 설치합니다.Or, press N and configure the PowerShell Gallery as a trusted repository by using the command Set-PSRepository -Name PSGallery -InstallationPolicy Trusted and then rerun the command to install the AADRM module.

이전 버전의 AADRM 모듈을 갤러리에서 설치한 경우에는 다음을 입력하여 최신 버전으로 업데이트합니다.If you have a previous version of the AADRM module installed from the Gallery, update it to the latest by typing:

Update-Module -Name AADRM

다음 단계Next steps

Windows PowerShell 세션에서 설치된 모듈의 버전을 확인합니다.In a Windows PowerShell session, confirm the version of the installed module. 이 검사는 이전 버전에서 업그레이드한 경우에 특히 중요합니다.This check is particularly important if you upgraded from an older version:

(Get-Module AADRM –ListAvailable).Version

참고: 이 명령이 실패하는 경우 먼저 Import-module AADRM을 실행합니다.Note: If this command fails, first run Import-Module AADRM.

사용할 수 있는 cmdlet을 보려면 다음을 입력합니다.To see which cmdlets are available, type the following:

Get-Command -Module AADRM

Get-Help <cmdlet_name> 명령을 사용하여 특정 cmdlet에 대한 도움말을 확인하고 -online 매개 변수를 사용하여 Microsoft 설명서 사이트에서 최신 도움말을 확인합니다.Use the Get-Help <cmdlet_name> command to see the Help for a specific cmdlet, and use the -online parameter to see the latest help on the Microsoft documentation site. 예를 들면 다음과 같습니다.For example:

Get-Help Connect-AadrmService -online

추가 정보는 다음 항목을 참조하세요.For more information:

Azure Rights ManagementAzure Rights Management 서비스를 구성하는 명령을 실행하려면 먼저 Connect-AadrmService cmdlet을 사용하여 서비스에 연결해야 합니다.Before you can run any commands that configure the Azure Rights ManagementAzure Rights Management service, you must connect to the service by using the Connect-AadrmService cmdlet. 최상의 방법으로 구성 명령을 실행했으면 Disconnect-AadrmService cmdlet을 사용하여 서비스에서 연결을 끊습니다.When you have finished running your configuration commands, as a best practice, disconnect from the service by using the Disconnect-AadrmService cmdlet. 연결을 끊지 않으면 비활성 기간 후 연결이 자동으로 끊어집니다.If you do not disconnect, the connection is automatically disconnected after a period of inactivity. 자동 연결 끊기 동작으로 인해 가끔 PowerShell 세션에서 다시 연결해야 할 수 있습니다.Because of the automatic disconnection behavior, you might find that you need to occasionally reconnect in a PowerShell session.

참고

Azure Rights Management 서비스가 아직 활성화하지 않은 경우 서비스에 연결한 후에 Enable-Aadrm cmdlet을 사용하여 활성화할 수 있습니다.If the Azure Rights Management service is not yet activated, you can do this after you have connected to the service, by using the Enable-Aadrm cmdlet.

설명Comments

주석 처리 전에 Microsoft 내부 규칙을 검토하시기 바랍니다.Before commenting, we ask that you review our House rules.