Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Utilize as seguintes informações para o ajudar a instalar o módulo Windows PowerShell para o serviço de encriptação Azure Right Management a partir de Proteção de Informações do Microsoft Purview. O nome deste módulo é AIPService e substitui a versão anterior com o nome AADRM.
Pode utilizar este módulo do PowerShell para administrar o serviço de encriptação do Azure Rights Management a partir da linha de comandos utilizando qualquer computador Windows que tenha uma ligação à Internet e que cumpra os pré-requisitos listados na secção seguinte. Windows PowerShell para o Azure Rights Management suporta scripting para automatização ou pode ser necessário para cenários de configuração avançados. Para obter mais informações sobre as tarefas e configurações de administração suportadas pelo módulo, veja Administrar o serviço Azure Rights Management com o PowerShell.
Pré-requisitos
Esta tabela lista os pré-requisitos para instalar e utilizar o módulo AIPService PowerShell para o serviço de encriptação Azure Rights Management.
| Requisito | Mais informações |
|---|---|
| Versão mínima do Windows PowerShell | Versão 3.0 Pode confirmar a versão do Windows PowerShell que está a $PSVersionTable executar ao escrever numa sessão do PowerShell. Se precisar de instalar uma versão posterior do Windows PowerShell, consulte Atualizar Windows PowerShell existentes. Tenha em atenção que o módulo AIPService do PowerShell só suporta Windows PowerShell. O PowerShell 7 não é suportado. |
| Versão mínima do Microsoft .NET Framework | Versão 4.8 Esta versão mínima do Microsoft .NET Framework está incluída nos sistemas operativos posteriores, mas se ainda não estiver instalada, pode transferir 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 utiliza. |
| Licença necessária | Tem de ter uma licença de produto para utilizar esta funcionalidade. Para obter mais informações, veja Orientações de licenciamento do Microsoft 365 para conformidade & de segurança – Descrições do Serviço. |
Se 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 cmdlets no módulo mais antigo para que todos os scripts existentes continuem a funcionar. O módulo antigo sai do suporte a 15 de julho de 2020.
Se instalou o módulo AADRM a partir do Galeria do PowerShell, para o desinstalar, inicie uma sessão do PowerShell com a opção Executar como Administrador e escreva:
Uninstall-Module -Name AADRM
Se instalou o módulo AADRM com a Ferramenta de Administração do Azure Rights Management, utilize os procedimentos para remover aplicações do Windows 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 Transferências da Microsoft.
Para instalar o módulo AIPService a partir do Galeria do PowerShell
Se não estiver familiarizado com a Galeria do PowerShell, consulte Introdução ao Galeria do PowerShell. Siga as instruções para os requisitos da galeria, que incluem a instalação do módulo PowerShellGet e o fornecedor 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 escreva:
Install-Module -Name AIPService
Se for avisado sobre a instalação a partir de um repositório não fidedigno, pode premir Y para confirmar. Em alternativa, prima N e configure o Galeria do PowerShell como um repositório fidedigno com o comando Set-PSRepository -Name PSGallery -InstallationPolicy Trusted e, em seguida, execute novamente o comando para instalar o módulo AIPService.
Se tiver uma versão anterior do módulo AIPService instalada a partir da Galeria, atualize-a para a versão mais recente ao escrever:
Update-Module -Name AIPService
Próximas etapas
Numa sessão Windows PowerShell, confirme a versão do módulo instalado. Este marcar é particularmente importante se tiver atualizado a partir de uma versão mais antiga:
(Get-Module AIPService –ListAvailable).Version
Observação
Se este comando falhar, execute primeiro Import-Module AIPService.
Para ver que cmdlets estão disponíveis, escreva o seguinte:
Get-Command -Module AIPService
Utilize o Get-Help <cmdlet_name> comando 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. Por exemplo:
Get-Help Connect-AipService -online
Para obter mais informações:
Lista completa de cmdlets disponíveis: Módulo AIPService
Lista dos principais cenários de configuração que suportam o PowerShell: Administrar o serviço Azure Rights Management com o PowerShell
Antes de poder executar quaisquer comandos que configurem o serviço Azure Rights Management, tem de se ligar ao serviço através do cmdlet Connect-AipService .
Quando terminar de executar os comandos de configuração, como melhor prática, desligue-se do serviço com o cmdlet Disconnect-AipService . Se não desligar, a ligação é automaticamente desligada após um período de inatividade. Devido ao comportamento de desconexão automática, poderá ter de voltar a ligar-se ocasionalmente numa sessão do PowerShell.
Observação
Se o serviço Azure Rights Management ainda não estiver ativado, pode fazê-lo depois de se ligar ao serviço através do cmdlet Enable-AipService .