Como instalar o módulo do PowerShell AIPService

Use as informações a seguir para ajudá-lo a instalar o módulo do Windows PowerShell para o serviço de proteção da Proteção de Informações do Azure. 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) a partir da linha de comando usando qualquer computador Windows que tenha uma conexão de Internet e que atenda aos pré-requisitos listados na próxima seção. O Windows PowerShell para Proteção de Informações do Azure oferece suporte a scripts para automação ou pode ser necessário para cenários de configuração avançada. Para obter mais informações sobre as tarefas de administração e as configurações que o módulo suporta, confira Administrar a proteção da Proteção de Informações do Azure usando o PowerShell.

Pré-requisitos

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

Requisito	Mais informações
Versão mínima do Windows PowerShell	Versão 3.0 Você pode confirmar a versão do Windows PowerShell em execução digitando $PSVersionTable em uma sessão do PowerShell. Se você precisar instalar uma versão mais recente do Windows PowerShell, confira Atualizar Windows PowerShell existente. Observe que o módulo do PowerShell AIPService oferece suporte apenas ao Windows PowerShell. Não há suporte para o PowerShell 7.
Versão mínima do Microsoft .NET Framework	Versão 4.8 Nota: Esta versão do Microsoft .NET Framework está incluída nos sistemas operacionais posteriores, portanto, deverá ser instalada manualmente apenas se o sistema operacional cliente for inferior ao Windows 8.0 ou o sistema operacional do servidor for inferior ao Windows Server 2012. Se a versão mínima do Microsoft .NET Framework ainda não estiver instalada, você poderá fazer download do Microsoft .NET Framework 4.8. Essa versão mínima do Microsoft .NET Framework é necessária para algumas das classes que o módulo AIPService usa.
Licença obrigatória	Você deve ter uma licença de produto para usar esse recurso. Para obter mais informações, consulte Diretrizes de licenciamento do Microsoft 365 para conformidade de segurança e conformidade - Descrições de serviço.

Caso você ainda não tenha instalado o módulo AADRM

O módulo AIPService substitui o módulo mais antigo, AADRM. Se você tiver o módulo mais antigo instalado, desinstale-o e, em seguida, 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 a funcionar. No entanto, planeje a atualização dessas 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 a partir da 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 a Administração do Windows Azure AD Rights Management.

Como instalar o módulo AIPService

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

Para instalar o módulo AIPService na Galeria do PowerShell

Se você não tem familiaridade com o PowerShell, confira Introdução à Galeria do PowerShell. Siga as instruções para os requisitos da galeria, que incluem a instalação do módulo PowerShellGet e do provedor NuGet.

Para ver detalhes sobre o módulo AIPService na Galeria do PowerShell, visite a página do 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 você for avisado sobre a instalação em um repositório não confiável, pressione Y para confirmar. Ou pressione N e configure a 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 na Galeria, atualize-a para a 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. Essa verificação é particularmente importante se você atualizou de uma versão mais antiga:

(Get-Module AIPService –ListAvailable).Version

Observação

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

Para ver quais cmdlets estão disponíveis, digite o seguinte:

Get-Command -Module AIPService

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

Get-Help Connect-AipService -online

Para mais informações:

• Lista completa de cmdlets disponíveis: AIPService Module

• Lista dos principais cenários de configuração que oferecem suporte ao PowerShell: Administrando a proteção da Proteção de Informações do Azure usando o PowerShell

Antes de executar qualquer comando que configure o serviço de proteção, você deve se conectar ao serviço usando o cmdlet Connect-AipService.

Quando terminar de executar os comandos de configuração, como melhor prática, desconecte-se do serviço usando o cmdlet Disconnect-AipService. Se você não se desconectar, a conexão será desconectada automaticamente após um período de inatividade. Devido ao comportamento de desconexão automática, você poderá ter que se reconectar ocasionalmente em 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.