Installazione del modulo PowerShell AIPService

Usare le informazioni seguenti per installare il modulo Windows PowerShell per il servizio protezione da Azure 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 protezione (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 Information Protection supporta lo scripting per l'automazione o potrebbe essere necessario per scenari di configurazione avanzati. Per altre informazioni sulle attività e le configurazioni di amministrazione supportate dal modulo, vedere Amministrazione istering protection di Azure Information Protection tramite PowerShell.

Prerequisiti

Questa tabella elenca i prerequisiti per installare e usare il modulo PowerShell AIPService per il servizio di protezione di Azure Information Protection.

Requisito Altre informazioni
Versione minima di Windows PowerShell Versione 3.0

È possibile confermare la versione di Windows PowerShell in esecuzione digitando $PSVersionTable in una sessione di PowerShell. Se è necessario installare una versione successiva di Windows PowerShell, vedere Aggiornamento di Windows PowerShell esistente.

Si noti che il modulo PowerShell AIPService supporta solo Windows PowerShell. PowerShell 7 non è supportato.
Versione minima di Microsoft .NET Framework Versione 4.8

Nota: questa versione di Microsoft .NET Framework è inclusa nei sistemi operativi successivi, pertanto è necessario installarla manualmente solo se il sistema operativo client è minore di Windows 8.0 o il sistema operativo server è minore di Windows Server 2012.

Se la versione minima di Microsoft .NET Framework 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 richiesta Per usare questa funzionalità, è necessario disporre di una licenza del prodotto. Per altre informazioni, vedere Linee guida sulle licenze di Microsoft 365 per sicurezza e conformità - Descrizioni dei servizi.

Se è installato il modulo AADRM

Il modulo AIPService sostituisce il modulo precedente, AADRM. Se il modulo precedente è installato, disinstallarlo e quindi installare il modulo AIPService.

Il modulo più recente include alias per i nomi dei cmdlet nel modulo precedente, in modo che gli script esistenti continuino a funzionare. Tuttavia, pianificare l'aggiornamento di questi riferimenti prima che il modulo precedente non sia supportato. Il supporto per il modulo AADRM terminerà il 15 luglio 2020.

Se è stato installato il modulo AADRM da PowerShell Gallery, per disinstallarlo, avviare una sessione di PowerShell con l'opzione Esegui come Amministrazione istrator e digitare:

Uninstall-Module -Name AADRM

Se il modulo AADRM è stato installato con azure Rights Management Amministrazione istration Tool, usare Programmi e funzionalità per disinstallare Windows Azure AD Rights Management Amministrazione istration.

Come installare il modulo AIPService

Il modulo AIPService si trova in PowerShell Gallery e non è disponibile nell'Area download Microsoft.

Se non si ha familiarità con PowerShell Gallery, vedere Introduzione a PowerShell Gallery. Seguire le istruzioni per i requisiti della raccolta, che includono l'installazione del modulo PowerShellGet e del provider NuGet.

Per informazioni dettagliate sul modulo AIPService in PowerShell Gallery, visitare la pagina AIPService.

Per installare il modulo AIPService, avviare una sessione di PowerShell con l'opzione Esegui come Amministrazione istrator e digitare:

Install-Module -Name AIPService

Se viene visualizzato un avviso relativo all'installazione da un repository non attendibile, è possibile 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 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 Import-Module AIPService.

Per verificare quali cmdlet sono 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:

Prima di poter eseguire tutti i comandi che configurano il servizio protezione, è necessario connettersi al servizio usando il cmdlet Connessione-AipService.

Al termine dell'esecuzione dei comandi di configurazione, è consigliabile 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 di protezione non è ancora attivato, è possibile eseguire questa operazione dopo la connessione al servizio usando il cmdlet Enable-AipService .