Instalar o módulo do AADRM PowerShellInstalling the AADRM PowerShell module

Aplica-se a: Azure Information Protection, Office 365Applies to: Azure Information Protection, Office 365

Utilize as seguintes informações para ajudar a instalar o módulo Windows PowerShell para o serviço Azure Rights Management do Azure Information Protection.Use the following information to help you install the Windows PowerShell module for the Azure Rights Management service from Azure Information Protection. O nome deste módulo é AADRM.The name of this module is AADRM.

Pode utilizar este módulo do PowerShell para administrar o serviço Azure Rights Management na linha de comandos, em qualquer computador que tenha uma ligação à Internet e que cumpra os pré-requisitos indicados na secção seguinte.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. O Windows PowerShell para o Azure Rights ManagementAzure Rights Management suporta o scripting para a automatização ou poderá ser necessário para cenários de configuração avançada.Windows PowerShell for Azure Rights ManagementAzure Rights Management supports scripting for automation or might be necessary for advanced configuration scenarios. Para obter mais informações sobre as tarefas de administração e as configurações que o módulo suporta, consulte Administrar o Azure Rights Management utilizando o Windows PowerShell.For more information about the administration tasks and configurations that the module supports, see Administering Azure Rights Management by Using Windows PowerShell.

Pré-requisitosPrerequisites

Esta tabela lista os pré-requisitos para instalar e utilizar o módulo do AADRM PowerShell para o serviço Azure Rights Management do Azure Information Protection.This table lists the prerequisites to install and use the AADRM PowerShell module for the Azure Rights Management service from Azure Information Protection.

RequisitoRequirement Mais informaçõesMore information
Versão mínima do Windows PowerShell: 3.0Minimum version of Windows PowerShell: 3.0 Pode confirmar a versão do Windows PowerShell que está a executar, escrevendo $PSVersionTable numa sessão do PowerShell.You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a PowerShell session.

Se precisar de instalar uma versão posterior do Windows PowerShell, consulte atualizar existentes do Windows PowerShell.If you need to install a later version of Windows PowerShell, see Upgrading existing Windows PowerShell.
Versão mínima do Microsoft .NET Framework: 4.5Minimum version of the Microsoft .NET Framework: 4.5

Nota: esta versão do Microsoft .NET Framework está incluída em sistemas operativos posteriores, pelo que apenas deve instalá-la manualmente se o sistema operativo cliente for inferior ao Windows 8.0 ou o sistema operativo do servidor for inferior ao 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.
Se a versão mínima do Microsoft .NET Framework não estiver já instalada, pode transferir o 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.

Esta versão mínima do Microsoft .NET Framework é necessário para algumas das classes que utiliza o módulo AADRM.This minimum version of the Microsoft .NET Framework is required for some of the classes that the AADRM module uses.

A partir da versão 2.5.0.0 do módulo AADRM, o assistente Microsoft Online Services início de sessão já não é necessário.Starting with version 2.5.0.0 of the AADRM module, the Microsoft Online Services Sign-In Assistant is no longer required.

Nota

Se tiver instalado uma versão do módulo AADRM com a ferramenta de administração do Azure Rights Management, utilize programas e funcionalidades desinstalar administração de gestão do Windows Azure AD Rights antes Instale a versão mais recente do módulo AADRM da galeria do PowerShell.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.

Como instalar o módulo AADRMHow to install the AADRM module

O módulo AADRM foi movido para o galeria do PowerShell e já não está disponível a Microsoft Download Center.The AADRM module has moved to the PowerShell Gallery and is no longer available from the Microsoft Download Center.

Se estiver familiarizado com a galeria do PowerShell, consulte o artigo introdução à galeria do PowerShell.If you're new to the PowerShell Gallery, see Get Started with the PowerShell Gallery. Siga as instruções para os requisitos de galeria, que incluem a instalar o módulo de PowerShellGet e o fornecedor do NuGet.Follow the instructions for the gallery requirements, which include installing the PowerShellGet module and the NuGet provider.

Para ver detalhes sobre o módulo AADRM na galeria do PowerShell, visite o página AADRM.To see details about the AADRM module on the PowerShell Gallery, visit the AADRM page.

Para instalar o módulo AADRM, inicie uma sessão do PowerShell com o executar como administrador opção e escreva:To install the AADRM module, start a PowerShell session with the Run as Administrator option, and type:

Install-Module -Name AADRM

Se estiver avisado sobre a instalação de um repositório não fidedigno, pode premir Y para confirmar.If you are warned about installing from an untrusted repository, you can press Y to confirm. Em alternativa, prima N e configurar a galeria do PowerShell como um repositório fidedigno, utilizando o comando Set-PSRepository -Name PSGallery -InstallationPolicy Trusted e, em seguida, volte a executar o comando para instalar o módulo 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.

Se tiver uma versão anterior do módulo AADRM instalado a partir da galeria, a atualização para a versão mais recente, escrevendo: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

Próximos passosNext steps

Numa sessão do Windows PowerShell, confirme a versão do módulo instalado.In a Windows PowerShell session, confirm the version of the installed module. Esta verificação é particularmente importante se tiver atualizado de uma versão mais antiga:This check is particularly important if you upgraded from an older version:

(Get-Module AADRM –ListAvailable).Version

Nota: se este comando falhar, execute primeiro Import-Module AADRM.Note: If this command fails, first run Import-Module AADRM.

Para ver os cmdlets disponíveis, escreva o seguinte:To see which cmdlets are available, type the following:

Get-Command -Module AADRM

Utilize o comando Get-Help <cmdlet_name> para ver a Ajuda de um cmdlet específico e utilize o parâmetro -online para ver a ajuda mais recente no site de documentação da 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. Por exemplo:For example:

Get-Help Connect-AadrmService -online

Para obter mais informações:For more information:

Antes de poder executar quaisquer comandos para configurar o serviço Azure Rights ManagementAzure Rights Management, tem de ligar ao serviço através do cmdlet Connect-AadrmService.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. Quando terminar de executar os comandos de configuração, como melhor prática, encerre o serviço através do cmdlet Disconnect-AadrmService.When you have finished running your configuration commands, as a best practice, disconnect from the service by using the Disconnect-AadrmService cmdlet. Se não desligar, a ligação é automaticamente desligada após um período de inatividade.If you do not disconnect, the connection is automatically disconnected after a period of inactivity. Devido ao comportamento de desativação automático, pode ter de voltar a ligar ocasionalmente numa sessão do PowerShell.Because of the automatic disconnection behavior, you might find that you need to occasionally reconnect in a PowerShell session.

Nota

Se ainda não ativou o serviço Azure Rights Management, pode fazê-lo depois de ligar ao serviço, através do cmdlet Enable-Aadrm.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.

ComentáriosComments

Antes de inserir um comentário, pedimos-lhe que reveja as nossas Regras básicas.Before commenting, we ask that you review our House rules.