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.
Use as informações a seguir para ajudá-lo a instalar o módulo PowerShell para o serviço de criptografia Gerenciamento de Direitos do Azure da Proteção de Informações do Microsoft Purview. O nome deste módulo é AIPService, e substitui a versão anterior que se chamava AADRM.
Você pode usar esse módulo do PowerShell para administrar o serviço de criptografia do 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 tabela a seguir. O PowerShell para o serviço Azure Rights Management dá suporte a scripts para automaçã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 que o módulo AIPService suporta, consulte Administrando o serviço Azure Rights Management 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 criptografia do Azure Rights Management.
| Requisito | Mais informações |
|---|---|
| Versões com suporte do PowerShell | Windows PowerShell 5.1 ou PowerShell 7.4 e posterior. Você pode confirmar a versão que está executando digitando $PSVersionTable em uma sessão do PowerShell. A PSEdition propriedade mostra Desktop para o Windows PowerShell e Core para o PowerShell 7. Para instalar o PowerShell 7, consulte Instalando o PowerShell no Windows. O PowerShell 7 requer o AIPService versão 3.1.0.0 ou posterior. As versões anteriores do módulo são compatíveis apenas com o Windows PowerShell. |
| Versão mínima do .NET | Windows PowerShell 5.1 requer o Microsoft .NET Framework 4.8. Esta versão mínima do Microsoft .NET Framework está incluída com os sistemas operacionais posteriores, mas se ainda não estiver instalada, você pode 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. O PowerShell 7.4 e posterior inclui a versão .NET que o módulo exige, portanto, nenhuma instalação separada é necessária. |
| Licença necessária | Você deve ter uma licença de produto para usar este recurso. Para obter mais informações, consulte a orientação de licenciamento do Microsoft 365 para conformidade com & de segurança - Descrições de serviço. |
Edições do PowerShell
A versão 3.1.0.0 do AIPService oferece suporte a ambas as edições do PowerShell no Windows a partir de um único pacote:
| Edição | Host | Tempo de execução |
|---|---|---|
| Desktop | Windows PowerShell 5.1 | .NET Framework 4.8 |
| Serviços básicos | PowerShell 7.4 e posterior | .NET 8 |
O módulo seleciona a edição correta automaticamente quando você o importa, para que o mesmo Install-Module comando funcione em ambos os hosts. Os nomes, parâmetros e saída de cmdlet são os mesmos em ambas as edições.
A entrada interativa é diferente entre as duas edições. O Windows PowerShell 5.1 entra por meio de um modo de exibição da Web incorporado, enquanto o PowerShell 7 usa seu navegador da Web padrão e um endereço de loopback local. Em um computador sem navegador padrão disponível, como em uma instalação Server Core ou em uma sessão remota, use a autenticação baseada em certificado ou da entidade de serviço. Para obter mais informações, consulte Connect-AipService.
Para confirmar quais edições sua versão instalada suporta, execute:
(Get-Module AIPService -ListAvailable).CompatiblePSEditions
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 AIPService tem aliases para os nomes de cmdlet no módulo AADRM para que todos os scripts existentes continuem funcionando. O módulo AADRM ficou sem suporte 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 os procedimentos de remoção de aplicativos do Windows 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 da Galeria do PowerShell
Se você for novo na Galeria do PowerShell, consulte Introdução à Galeria do PowerShell. Siga as instruções de configuração da Galeria do PowerShell, incluindo a instalação do módulo PowerShellGet e do provedor NuGet.
Para ver detalhes sobre o módulo AIPService na Galeria do PowerShell, visite o pacote AIPService na Galeria do PowerShell.
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 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 Set-PSRepository -Name PSGallery -InstallationPolicy Trusted e, em seguida, execute novamente o comando 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
Observação
Para usar o módulo no PowerShell 7, execute Install-Module -Name AIPService em uma sessão do PowerShell 7. O Windows PowerShell e o PowerShell 7 usam pastas de módulo separadas por usuário, portanto, um módulo que foi instalado para o usuário atual no Windows PowerShell não está disponível no PowerShell 7.
Próximas etapas
Em uma sessão do PowerShell, confirme a versão do módulo instalado. Essa marcação é particularmente importante se você atualizou de uma versão mais antiga:
(Get-Module AIPService -ListAvailable).Version
Observação
Se (Get-Module AIPService -ListAvailable).Version falhar, execute primeiro Import-Module AIPService.
Para ver quais cmdlets estão disponíveis, digite o seguinte:
Get-Command -Module AIPService
Use o Get-Help <cmdlet_name> comando para consultar a Ajuda de um cmdlet específico e use o parâmetro -online para obter 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 dão suporte ao PowerShell: Administrar o serviço Azure Rights Management usando o PowerShell
Antes de executar qualquer comando que configure o serviço do Azure Rights Management, 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á desconectada automaticamente 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.
Observação
Se o serviço do Azure Rights Management ainda não estiver ativado, você poderá ativá-lo depois de se conectar ao serviço usando o cmdlet Enable-AipService.