Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez les informations suivantes pour vous aider à installer le module Windows PowerShell pour le service de chiffrement Azure Right Management à partir de Protection des données Microsoft Purview. 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 chiffrement Azure Rights Management à partir de la ligne de commande à l’aide de n’importe quel ordinateur Windows disposant d’une connexion Internet et répondant aux conditions préalables indiquées dans la section suivante. Windows PowerShell pour Azure Rights Management prend en charge les scripts pour l’automatisation ou peut être nécessaire pour les scénarios de configuration avancés. Pour plus d’informations sur les tâches d’administration et les configurations que le module prend en charge, consultez Administration du service Azure Rights Management à l’aide de PowerShell.
Configuration requise
Ce tableau répertorie les conditions préalables à l’installation et à l’utilisation du module PowerShell AIPService pour le service de chiffrement Azure Rights Management.
| Conditions requises | Plus d’informations |
|---|---|
| Version minimale de Windows PowerShell | Version 3.0 Vous pouvez confirmer 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 Mise à niveau de Windows PowerShell existants. Notez que le module PowerShell AIPService prend uniquement en charge Windows PowerShell. PowerShell 7 n’est pas pris en charge. |
| Version minimale de Microsoft .NET Framework | Version 4.8 Cette version minimale de Microsoft .NET Framework est incluse avec les systèmes d’exploitation ultérieurs, mais si elle n’est pas déjà installée, vous pouvez télécharger Microsoft .NET Framework 4.8. Cette version minimale de Microsoft .NET Framework est requise pour certaines des classes utilisées par le module AIPService. |
| Licence requise | Vous devez disposer d’une licence de produit pour utiliser cette fonctionnalité. Pour plus d’informations, consultez Guide de gestion des licences Microsoft 365 pour la sécurité & la conformité - Descriptions du service. |
Si le module AADRM est installé
Le module AIPService remplace l’ancien module, AADRM. Si l’ancien module est installé, désinstallez-le, puis installez le module AIPService.
Le module le plus récent a des alias pour les noms d’applet de commande dans l’ancien module afin que tous les scripts existants continuent de fonctionner. L’ancien module n’est plus pris en charge le 15 juillet 2020.
Si vous avez installé le module AADRM à partir du 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 vos procédures de suppression d’applications Windows pour désinstaller Windows Azure AD Rights Management Administration.
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.
Pour installer le module AIPService à partir du PowerShell Gallery
Si vous débutez avec le PowerShell Gallery, consultez Prise en main du PowerShell Gallery. Suivez les instructions relatives à la configuration requise de la galerie, notamment l’installation du module PowerShellGet et du fournisseur NuGet.
Pour afficher des détails sur le module AIPService sur le PowerShell Gallery, visitez 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 êtes averti de l’installation à partir d’un dépôt non approuvé, vous pouvez appuyer sur Y pour confirmer. Vous pouvez également 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 avez installé une version précédente du module AIPService à partir de la galerie, mettez-la à jour en tapant :
Update-Module -Name AIPService
Étapes suivantes
Dans une session Windows PowerShell, vérifiez la version du module installé. Cette case activée est particulièrement importante si vous avez effectué une mise à niveau à partir d’une version antérieure :
(Get-Module AIPService –ListAvailable).Version
Remarque
Si cette commande échoue, commencez par exécuter Import-Module AIPService.
Pour connaître les applets de commande disponibles, tapez ce qui suit :
Get-Command -Module AIPService
Utilisez la Get-Help <cmdlet_name> commande pour afficher l’aide d’une applet de commande spécifique et utilisez le paramètre -online pour afficher l’aide la plus récente sur le site de documentation Microsoft. Par exemple :
Get-Help Connect-AipService -online
En savoir plus :
Liste complète des applets de commande disponibles : Module AIPService
Liste des principaux scénarios de configuration qui prennent en charge PowerShell : Administration du service Azure Rights Management à l’aide de PowerShell
Avant de pouvoir exécuter des commandes qui configurent le service Azure Rights Management, vous devez vous connecter au service à l’aide de l’applet de commande Connect-AipService.
Lorsque vous avez terminé d’exécuter vos commandes de configuration, il est recommandé de vous déconnecter du service à l’aide de l’applet de commande Disconnect-AipService . Si vous ne vous déconnectez pas, la connexion est automatiquement déconnectée après une période d’inactivité. En raison du comportement de déconnexion automatique, vous pouvez constater que vous devez occasionnellement vous reconnecter dans une session PowerShell.
Remarque
Si le service Azure Rights Management 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.