Installation du module PowerShell AIPService

S’applique à : Azure Information Protection, Office 365

Concerne : Client d’étiquetage unifié AIP et client classique

Notes

Pour fournir une expérience client unifiée et homogène, le client classique Azure Information Protection et la gestion des étiquettes dans le portail Azure sont dépréciés depuis le 31 mars 2021. Le client classique continue de fonctionner selon la configuration, mais aucun support n’est fourni, et les versions de maintenance ne sont plus publiées pour le client classique.

Nous vous recommandons de passer à l’étiquetage unifié et d’effectuer la mise à niveau vers le client d’étiquetage unifié. En savoir plus sur notre récent blog de dépréciation.

utilisez les informations suivantes pour vous aider à installer le module Windows PowerShell pour le service de protection à partir de Azure Information Protection. Le nom de ce module est AIPService et remplace la version précédente nommée AADRM.

vous pouvez utiliser ce module PowerShell pour administrer le service de protection (Azure Rights Management) à partir de la ligne de commande à l’aide de n’importe quel ordinateur Windows disposant d’une connexion internet et qui satisfait aux conditions préalables indiquées dans la section suivante. Windows PowerShell pour Azure Information Protection prend en charge l’écriture de scripts pour l’automatisation ou peut être nécessaire pour les scénarios de configuration avancée. Pour plus d’informations sur les tâches d’administration et les configurations prises en charge par le module, consultez administration de la protection à partir de Azure information protection à l’aide de PowerShell.

Prérequis

Ce tableau répertorie les conditions préalables à l’installation et l’utilisation du module PowerShell AIPService pour le service de protection de Azure Information Protection.

Condition requise Informations complémentaires
Version minimale de Windows PowerShell Version 3.0

Vous pouvez vérifier la version de Windows PowerShell que vous exécutez en tapant $PSVersionTable dans une session PowerShell. Si vous devez installer une version ultérieure de Windows PowerShell, consultez Upgrading existing Windows PowerShell (Mise à niveau de Windows PowerShell existant).
Version minimale de Microsoft .NET Framework Version 4.5

remarque: cette version de l' .NET Framework Microsoft est incluse avec les systèmes d’exploitation ultérieurs. par conséquent, vous devez l’installer manuellement uniquement si votre système d’exploitation client est inférieur à Windows 8.0 ou si votre système d’exploitation serveur est inférieur à Windows Server 2012.

si la version minimale de microsoft .NET Framework n’est pas déjà installée, vous pouvez télécharger microsoft .NET Framework 4,5. cette version minimale du .NET Framework Microsoft est requise pour certaines des classes utilisées par le module AIPService.
Licence obligatoire Vous devez disposer d’une licence de produit pour utiliser cette fonctionnalité. pour plus d’informations, consultez Microsoft 365 aide sur les licences pour la sécurité & conformité-description du Service.

Si le module AADRM est installé

Le module AIPService remplace l’ancien module, AADRM. Si vous avez installé l’ancien module, désinstallez-le, puis installez le module AIPService.

Le module plus récent a des alias pour les noms d’applets de commande dans l’ancien module afin que tous les scripts existants continuent de fonctionner. Toutefois, prévoyez de mettre à jour ces références avant que l’ancien module ne soit pris en charge. La prise en charge du module AADRM se terminera le 15 juillet 2020.

Si vous avez installé le module AADRM à partir de la PowerShell Gallery, pour le désinstaller, démarrez une session PowerShell avec l’option exécuter en tant qu’administrateur , puis tapez :

Uninstall-Module -Name AADRM

si vous avez installé le module AADRM avec l’outil d’administration Azure Rights Management, utilisez programmes et fonctionnalités pour désinstaller Windows Azure AD administration de l’Rights Management.

Comment installer le module AIPService

Le module AIPService se trouve sur le PowerShell Gallery et n’est pas disponible dans le centre de téléchargement Microsoft.

Si vous n’avez jamais utilisé PowerShell Gallery, consultez Bien démarrer avec PowerShell. Suivez les instructions relatives à la configuration requise de la galerie, avec notamment l’installation du module PowerShellGet et du fournisseur NuGet.

Pour plus d’informations sur le module AIPService sur la PowerShell Gallery, consultez la page AIPService.

Pour installer le module AIPService, démarrez une session PowerShell avec l’option exécuter en tant qu’administrateur , puis tapez :

Install-Module -Name AIPService

Si vous recevez un avertissement indiquant que l’installation est effectuée à partir d’un dépôt non approuvé, vous pouvez appuyer sur O pour confirmer. Vous pouvez aussi appuyer sur N et configurer le PowerShell Gallery en tant que référentiel approuvé à l’aide de la commande Set-PSRepository -Name PSGallery -InstallationPolicy Trusted , puis réexécuter la commande pour installer le module AIPService.

Si vous disposez d’une version précédente du module AIPService installée à partir de la Galerie, mettez-la à jour avec la dernière version en tapant ce qui suit :

Update-Module -Name AIPService

Étapes suivantes

Dans une session Windows PowerShell, confirmez la version du module installé. Cette vérification est particulièrement importante si vous avez mis à niveau à partir d’une version antérieure :

(Get-Module AIPService –ListAvailable).Version

Notes

Si cette commande échoue, exécutez d’abord import-module AIPService.

Pour voir les applets de commande disponibles, tapez la commande suivante :

Get-Command -Module AIPService

Utilisez la commande Get-Help <cmdlet_name> pour afficher l’aide relative à une applet de commande spécifique, et utilisez le paramètre -online pour afficher l’aide la plus récente sur le site de la documentation de Microsoft. Par exemple :

Get-Help Connect-AipService -online

Pour plus d’informations :

avant de pouvoir exécuter des commandes qui configurent le service de protection, vous devez vous connecter au service à l’aide de l’applet de commande Connecter-AipService .

Lorsque vous avez terminé d’exécuter vos commandes de configuration, il est recommandé de se déconnecter du service à l’aide de l’applet de commande Disconnect-AipService . Si vous ne vous déconnectez pas, la connexion est interrompue automatiquement après une période d’inactivité. En raison du comportement de déconnexion automatique, vous constaterez que vous devrez occasionnellement vous reconnecter à une session PowerShell.

Notes

Si le service de protection n’est pas encore activé, vous pouvez le faire après vous être connecté au service, à l’aide de l’applet de commande Enable-AipService .