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 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 Azure Rights Management dalla riga di comando usando qualsiasi computer Windows che disponga di una connessione Internet e soddisfi i prerequisiti elencati nella tabella seguente. PowerShell per il servizio Azure Rights Management supporta gli script per l'automazione o potrebbe essere necessario per scenari di configurazione avanzati. Per altre informazioni sulle attività di amministrazione e sulle configurazioni supportate dal modulo AIPService, vedere Amministrazione del servizio Azure Rights Management tramite PowerShell.
Prerequisiti
Questa tabella elenca i prerequisiti per installare e usare il modulo di PowerShell AIPService per il servizio di crittografia Azure Rights Management.
| Requisito | Ulteriori informazioni |
|---|---|
| Versioni di PowerShell supportate | Windows PowerShell 5.1 o PowerShell 7.4 e versioni successive. È possibile confermare la versione in esecuzione digitando $PSVersionTable in una sessione di PowerShell. La PSEdition proprietà viene visualizzata Desktop per Windows PowerShell e Core PowerShell 7. Per installare PowerShell 7, vedere Installazione di PowerShell in Windows. PowerShell 7 richiede AIPService versione 3.1.0.0 o successiva. Le versioni precedenti del modulo supportano solo Windows PowerShell. |
| Versione .NET minima | Windows PowerShell 5.1 richiede Microsoft .NET Framework 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 utilizzate dal modulo AIPService. PowerShell 7.4 e versioni successive include la versione .NET richiesta dal modulo, quindi non è necessaria un'installazione separata. |
| Licenza necessaria | Per usare questa funzionalità, è necessario avere una licenza del prodotto. Per altre informazioni, vedere Indicazioni sulle licenze di Microsoft 365 per la sicurezza & la conformità - Descrizioni dei servizi. |
Edizioni di PowerShell
AIPService versione 3.1.0.0 supporta entrambe le edizioni di PowerShell in Windows da un singolo pacchetto:
| Edition | Host | Runtime |
|---|---|---|
| Desktop | Windows PowerShell 5.1 | .NET Framework 4.8 |
| Core | PowerShell 7.4 e versioni successive | .NET 8 |
Il modulo seleziona automaticamente l'edizione corretta quando la importi, quindi lo stesso Install-Module comando funziona in entrambi gli host. I nomi dei cmdlet, i parametri e l'output sono gli stessi in entrambe le edizioni.
L'accesso interattivo varia a seconda delle due edizioni. Windows PowerShell 5.1 accede tramite una visualizzazione Web incorporata, mentre PowerShell 7 utilizza il Web browser predefinito e un indirizzo di loopback locale. In un computer senza browser predefinito disponibile, come un'installazione Server Core, o in una sessione remota, usare invece l'autenticazione basata su certificato o dell'entità servizio. Per ulteriori informazioni, vedere Connect-AIPSERVICE.
Per verificare quali edizioni supporta la versione installata, esegui:
(Get-Module AIPService -ListAvailable).CompatiblePSEditions
Se hai 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 AIPService ha alias per i nomi dei cmdlet nel modulo AADRM in modo che gli script esistenti continuino a funzionare. Il modulo AADRM non è più supportato il 15 luglio 2020.
Se il modulo AADRM è stato installato da PowerShell Gallery, per disinstallarlo, avviare una sessione di PowerShell con l'opzione Esegui come amministratore e digitare:
Uninstall-Module -Name AADRM
Se il modulo AADRM è stato installato con lo strumento Azure Rights Management Administration, usare le procedure di rimozione delle applicazioni di Windows per disinstallare Windows Azure AD Rights Management Administration.
Come installare il modulo AIPService
Il modulo AIPService si trova in PowerShell Gallery e non è disponibile nell'Area download Microsoft.
Per installare il modulo AIPService da PowerShell Gallery
Se non si ha familiarità con PowerShell Gallery, vedere Introduzione a PowerShell Gallery. Seguire le istruzioni di configurazione di PowerShell Gallery, inclusa l'installazione del modulo PowerShellGet e del provider NuGet.
Per visualizzare i dettagli sul modulo AIPService in PowerShell Gallery, visitare il pacchetto AIPService in PowerShell Gallery.
Per installare il modulo AIPService, avviare una sessione di PowerShell con l'opzione Esegui come amministratore e digitare:
Install-Module -Name AIPService
Se vieni avvisato dell'installazione da un repository non attendibile, puoi premere Y per confermare. In alternativa, premere N e configurare PowerShell Gallery come repository attendibile usando il comando Set-PSRepository -Name PSGallery -InstallationPolicy Trusted e quindi eseguire nuovamente il comando per installare il modulo AIPService.
Se si ha una versione precedente del modulo AIPService installata dalla raccolta, aggiornarla alla più recente digitando:
Update-Module -Name AIPService
Nota
Per usare il modulo in PowerShell 7, eseguirlo Install-Module -Name AIPService da una sessione di PowerShell 7. Windows PowerShell e PowerShell 7 usano cartelle di moduli separate per utente, quindi un modulo installato per l'utente corrente in Windows PowerShell non è disponibile in PowerShell 7.
Passaggi successivi
In una sessione di PowerShell confermare la versione del modulo installato. Questo controllo è particolarmente importante se hai eseguito l'aggiornamento da una versione precedente:
(Get-Module AIPService -ListAvailable).Version
Nota
Se (Get-Module AIPService -ListAvailable).Version fallisce, esegui prima 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 di un cmdlet specifico e il parametro -online per visualizzare la Guida più recente sul 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 qualsiasi comando che configura il servizio Azure Rights Management, è necessario connettersi al servizio usando il cmdlet Connect-AIPSERVICE.
Al termine dell'esecuzione dei comandi di configurazione, è consigliabile disconnettersi dal servizio utilizzando il cmdlet Disconnect-AIPSERVICE . Se non ci si disconnette, la connessione viene automaticamente disconnessa 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 attivarlo dopo essersi connessi al servizio usando il cmdlet Enable-AipService.