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.
Para instalar o módulo AIPService do Galeria do PowerShell
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:
Lista completa de cmdlets disponíveis: Módulo AIPService
Lista dos principais cenários de configuração que dão suporte ao PowerShell: Administrando a proteção do Azure Proteção de Informações usando o PowerShell
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 .