Instalando o módulo AIPService PowerShell

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 que se chamava 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 com a Internet e que atenda aos pré-requisitos listados na próxima seção. O Windows PowerShell para Proteção de Informações do Azure dá 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 configurações suportadas pelo módulo, consulte Administrando 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 AIPService PowerShell para o serviço de proteção da Proteção de Informações do Azure.

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

Você pode confirmar a versão do Windows PowerShell que está executando digitando $PSVersionTable em uma sessão do PowerShell. Se precisar de instalar uma versão mais recente do Windows PowerShell, veja Atualizar o Windows PowerShell existente.

Observação O módulo AIPService PowerShell oferece suporte apenas ao Windows PowerShell. O PowerShell 7 não é suportado.
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 operativos posteriores, pelo que deverá ter de instalá-la manualmente apenas se o sistema operativo cliente for inferior ao Windows 8.0 ou se o sistema operativo 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á baixar o Microsoft .NET Framework 4.8. Esta 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 Diretrizes de licenciamento do Microsoft 365 para segurança e conformidade - 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 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 atualizar essas referências antes que o módulo antigo caia fora do suporte. O suporte para o módulo AADRM terminará em 15 de julho de 2020.

Se você instalou o módulo AADRM 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.

Se você for novo na Galeria do PowerShell, consulte 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 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 a partir de 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 e, em seguida, execute novamente o comando Set-PSRepository -Name PSGallery -InstallationPolicy Trusted para instalar o módulo AIPService.

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

Update-Module -Name AIPService

Próximos passos

Em uma sessão do Windows PowerShell, confirme a versão do módulo instalado. Esta verificação é particularmente importante se tiver atualizado a partir de uma versão mais antiga:

(Get-Module AIPService –ListAvailable).Version

Nota

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

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

Get-Command -Module AIPService

Use o comando para ver a Ajuda de um cmdlet específico e use o Get-Help <cmdlet_name>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:

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

Nota

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 .