Como instalar o módulo do PowerShell do AIPService

Use as informações a seguir para ajudá-lo a instalar o módulo Windows PowerShell para o serviço de proteção do Azure Proteção de Informações. O nome deste módulo é AIPService e substitui a versão anterior chamada AADRM.

Você pode usar este módulo do PowerShell para administrar o serviço de proteção (Azure Rights Management) da linha de comando usando qualquer computador Windows que tenha uma conexão com a Internet e que atenda aos pré-requisitos listados na próxima seção. Windows PowerShell para o Azure Proteção de Informações dá suporte ao script para automação ou pode ser necessário para cenários de configuração avançados. Para obter mais informações sobre as tarefas de administração e as configurações compatíveis com o módulo, consulte Administrando a proteção do Azure Proteção de Informações usando o PowerShell.

Pré-requisitos

Esta tabela lista os pré-requisitos para instalar e usar o módulo AIPService PowerShell para o serviço de proteção do Azure Proteção de Informações.

Requisito Mais informações
Versão mínima do Windows PowerShell Versão 3.0

Confirme a versão do Windows PowerShell que você está executando digitando $PSVersionTable em uma sessão do PowerShell. Se você precisar instalar uma versão mais recente do Windows PowerShell, consulte Atualizar Windows PowerShell existente.
Versão mínima do Microsoft .NET Framework Versão 4.5

Observação: essa versão do microsoft .NET Framework está incluída nos sistemas operacionais posteriores, portanto, você deve precisar instalá-lo manualmente somente se o sistema operacional cliente for menor que Windows 8.0 ou o sistema operacional do servidor for menor que Windows Server 2012.

Se a versão mínima do Microsoft .NET Framework ainda não estiver instalada, você poderá baixar o Microsoft .NET Framework 4.5. Essa versão mínima do microsoft .NET Framework é necessária para algumas das classes que o módulo AIPService usa.
Licença necessária Você deve ter uma licença de produto para usar esse recurso. Para obter mais informações, consulte as diretrizes de licenciamento do Microsoft 365 para conformidade de segurança & – Descrições de serviço.

Se você tiver o módulo AADRM instalado

O módulo AIPService substitui o módulo mais antigo, AADRM. Se você tiver o módulo mais antigo instalado, desinstale-o e instale o módulo AIPService.

O módulo mais recente tem aliases para os nomes de cmdlet no módulo mais antigo para que todos os scripts existentes continuem funcionando. No entanto, planeje atualizar essas referências antes que o módulo antigo fique sem suporte. O suporte para o módulo AADRM terminará em 15 de julho de 2020.

Se você instalou o módulo AADRM do Galeria do PowerShell, para desinstalá-lo, inicie uma sessão do PowerShell com a opção Executar como Administrador e digite:

Uninstall-Module -Name AADRM

Se você instalou o módulo AADRM com a Ferramenta de Administração do Azure Rights Management, use Programas e Recursos para desinstalar o Windows Azure AD Rights Management Administration.

Como instalar o módulo AIPService

O módulo AIPService está no Galeria do PowerShell e não está disponível no Centro de Download da Microsoft.

Se você não estiver familiarizado com a Galeria do PowerShell, consulte Introdução à Galeria do PowerShell. Siga as instruções dos requisitos da galeria, que incluem a instalação do módulo PowerShellGet e o provedor do NuGet.

Para ver detalhes sobre o módulo AIPService no Galeria do PowerShell, visite a página AIPService.

Para instalar o módulo AIPService, inicie uma sessão do PowerShell com a opção Executar como Administrador e digite:

Install-Module -Name AIPService

Se for avisado sobre a instalação de um repositório não confiável, pressione Y para confirmar. Ou pressione N e configure o Galeria do PowerShell como um repositório confiável usando o comando Set-PSRepository -Name PSGallery -InstallationPolicy Trusted e execute novamente o comando para instalar o módulo AIPService.

Se você tiver uma versão anterior do módulo AIPService instalada da Galeria, atualize-a para a versão mais recente digitando:

Update-Module -Name AIPService

Próximas etapas

Em uma sessão do Windows PowerShell, confirme a versão do módulo instalado. Esta verificação é especialmente importante quando você atualiza de uma versão anterior:

(Get-Module AIPService –ListAvailable).Version

Observação

Se esse comando falhar, primeiro execute Import-Module AIPService.

Para conferir os cmdlets disponíveis, digite o seguinte:

Get-Command -Module AIPService

Use o comando Get-Help <cmdlet_name> para exibir a Ajuda de um cmdlet específico e use o parâmetro -online para exibir a ajuda mais recente, no site de documentação da Microsoft. Por exemplo:

Get-Help Connect-AipService -online

Para mais informações:

Antes de executar quaisquer comandos que configurem o serviço de proteção, você deve se conectar ao serviço usando o cmdlet Connect-AipService .

Quando terminar de executar seus comandos de configuração, como prática recomendada, desconecte-se do serviço usando o cmdlet Disconnect-AipService . Se não fizer isso, a conexão será automaticamente interrompida, após um determinado período de inatividade. Devido ao comportamento de desconexão automática, talvez você considere necessário reconectar ocasionalmente uma sessão do PowerShell.

Observação

Se o serviço de proteção ainda não estiver ativado, você poderá fazer isso depois de se conectar ao serviço usando o cmdlet Enable-AipService .