Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Usare le informazioni seguenti per installare il modulo Windows PowerShell per il servizio di crittografia Azure Right Management da Microsoft Purview Information Protection. Il nome di questo modulo è AIPService e sostituisce la versione precedente denominata AADRM.
È possibile usare questo modulo di PowerShell per amministrare il servizio di crittografia di Azure Rights Management dalla riga di comando usando qualsiasi computer Windows con connessione Internet e che soddisfi i prerequisiti elencati nella sezione successiva. Windows PowerShell per Azure Rights Management supporta lo scripting per l'automazione o potrebbe essere necessario per scenari di configurazione avanzati. Per altre informazioni sulle attività di amministrazione e le configurazioni supportate dal modulo, vedere Amministrazione del servizio Azure Rights Management tramite PowerShell.
Prerequisiti
Questa tabella elenca i prerequisiti per installare e usare il modulo PowerShell AIPService per il servizio di crittografia Azure Rights Management.
| Requisito | Ulteriori informazioni |
|---|---|
| Versione minima di Windows PowerShell | Versione 3.0 È possibile confermare la versione di Windows PowerShell in esecuzione digitando $PSVersionTable una sessione di PowerShell. Se è necessario installare una versione successiva di Windows PowerShell, vedere Aggiornamento di Windows PowerShell esistenti. Si noti che il modulo PowerShell AIPService supporta solo Windows PowerShell. PowerShell 7 non è supportato. |
| Versione minima di Microsoft .NET Framework | Versione 4.8 Questa versione minima di Microsoft .NET Framework è inclusa nei sistemi operativi successivi, ma se non è già installata, è possibile scaricare Microsoft .NET Framework 4.8. Questa versione minima di Microsoft .NET Framework è necessaria per alcune delle classi usate dal modulo AIPService. |
| Licenza necessaria | Per usare questa funzionalità, è necessario disporre di una licenza di prodotto. Per altre informazioni, vedere Indicazioni sulle licenze di Microsoft 365 per la conformità & sicurezza - Descrizioni del servizio. |
Se è installato il modulo AADRM
Il modulo AIPService sostituisce il modulo precedente, AADRM. Se è installato il modulo precedente, disinstallarlo e quindi installare il modulo AIPService.
Il modulo più recente include alias per i nomi dei cmdlet nel modulo precedente in modo che tutti gli script esistenti continuino a funzionare. Il modulo precedente non supporta il 15 luglio 2020.
Se il modulo AADRM è stato installato dal PowerShell Gallery, per disinstallarlo, avviare una sessione di PowerShell con l'opzione Esegui come amministratore e digitare:
Uninstall-Module -Name AADRM
Se è stato installato il modulo AADRM con lo strumento di amministrazione di Azure Rights Management, usare le procedure di rimozione delle applicazioni di Windows per disinstallare Amministrazione di Windows Azure AD Rights Management.
Come installare il modulo AIPService
Il modulo AIPService si trova nel PowerShell Gallery e non è disponibile nell'Area download Microsoft.
Per installare il modulo AIPService dal PowerShell Gallery
Se non si ha familiarita' con il PowerShell Gallery, vedere Introduzione all'PowerShell Gallery. Seguire le istruzioni per i requisiti della raccolta, tra cui l'installazione del modulo PowerShellGet e del provider NuGet.
Per informazioni dettagliate sul modulo AIPService nel PowerShell Gallery, visitare la pagina AIPService.
Per installare il modulo AIPService, avviare una sessione di PowerShell con l'opzione Esegui come amministratore e digitare:
Install-Module -Name AIPService
Se viene segnalato l'installazione da un repository non attendibile, è possibile premere Y per confermare. In alternativa, premere N e configurare il PowerShell Gallery come repository attendibile usando il comando Set-PSRepository -Name PSGallery -InstallationPolicy Trusted e quindi eseguire di nuovo il comando per installare il modulo AIPService.
Se è installata una versione precedente del modulo AIPService dalla raccolta, aggiornarla alla versione più recente digitando:
Update-Module -Name AIPService
Passaggi successivi
In una sessione di Windows PowerShell verificare la versione del modulo installato. Questo controllo è particolarmente importante se è stato eseguito l'aggiornamento da una versione precedente:
(Get-Module AIPService –ListAvailable).Version
Nota
Se questo comando ha esito negativo, eseguire prima di tutto Import-Module AIPService.
Per visualizzare i cmdlet disponibili, digitare quanto segue:
Get-Command -Module AIPService
Usare il Get-Help <cmdlet_name> comando per visualizzare la Guida per un cmdlet specifico e usare il parametro -online per visualizzare la Guida più recente nel sito della documentazione Microsoft. Ad esempio:
Get-Help Connect-AipService -online
Per altre informazioni:
Elenco completo dei cmdlet disponibili: modulo AIPService
Elenco dei principali scenari di configurazione che supportano PowerShell: Amministrazione del servizio Azure Rights Management tramite PowerShell
Prima di poter eseguire tutti i comandi che configurano il servizio Azure Rights Management, è necessario connettersi al servizio usando il cmdlet Connect-AipService .
Al termine dell'esecuzione dei comandi di configurazione, come procedura consigliata, disconnettersi dal servizio usando il cmdlet Disconnect-AipService . Se non si esegue la disconnessione, la connessione viene disconnessa automaticamente dopo un periodo di inattività. A causa del comportamento di disconnessione automatica, potrebbe essere necessario riconnettersi occasionalmente in una sessione di PowerShell.
Nota
Se il servizio Azure Rights Management non è ancora attivato, è possibile eseguire questa operazione dopo la connessione al servizio usando il cmdlet Enable-AipService .