Installation du module PowerShell AIPService

  • Article

Utilisez les informations suivantes pour vous aider à installer le module Windows PowerShell pour le service de protection à partir d’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 répond aux conditions préalables répertoriées dans la section suivante. Windows PowerShell pour Azure Information Protection 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 aître protection contre 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 à partir d’Azure Information Protection.

Condition requise 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 Upgrading existing Windows PowerShell (Mise à niveau de Windows PowerShell existant).

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

Remarque : cette version de Microsoft .NET Framework est incluse avec les systèmes d’exploitation ultérieurs. Vous devez donc l’installer manuellement uniquement si votre système d’exploitation client est inférieur à Windows 8.0 ou que 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.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 les instructions relatives aux licences Microsoft 365 pour la sécurité et la conformité - Descriptions des services.

Si vous avez installé le module AADRM

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, envisagez de mettre à jour ces références avant que l’ancien module ne soit pris en charge. La prise en charge du module AADRM prendra fin le 15 juillet 2020.

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

Uninstall-Module -Name AADRM

Si vous avez installé le module AADRM avec l’outil Azure Rights Management Administration, utilisez Programmes et Fonctionnalités pour désinstaller Windows Azure AD Rights Management Administration.

Comment installer le module AIPService

Le module AIPService se trouve sur PowerShell Gallery et n’est pas disponible à partir du Centre de téléchargement Microsoft.

Si vous débutez avec PowerShell, consultez Démarrer avec PowerShell Gallery. Suivez les instructions relatives aux exigences de la galerie, notamment l’installation du module PowerShellGet et du fournisseur NuGet.

Pour plus d’informations sur le module AIPService sur 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 et tapez :

Install-Module -Name AIPService

Si vous êtes averti de l’installation à partir d’un référentiel non approuvé, vous pouvez appuyer sur Y pour confirmer. Ou appuyez sur N et configurez PowerShell Gallery en tant que référentiel approuvé à l’aide de la commande Set-PSRepository -Name PSGallery -InstallationPolicy Trusted puis réexécutez la commande pour installer le module AIPService.

Si vous avez une version précédente du module AIPService installée à partir de la galerie, mettez-la à jour vers la dernière version en tapant :

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 effectué une mise à niveau à partir d’une version antérieure :

(Get-Module AIPService –ListAvailable).Version

Remarque

Si cette commande échoue, exécutez d’abord Import-Module AIPService.

Pour voir quelles applets de commande sont 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 la dernière aide sur le site de documentation Microsoft. Par exemple :

Get-Help Connect-AipService -online

Pour plus d'informations :

Avant de pouvoir exécuter toutes les commandes qui configurent le service de protection, vous devez vous connecter au service à l’aide de l’applet de commande Connect-AipService.

Une fois que vous avez terminé d’exécuter vos commandes de configuration, en guise de bonne pratique, déconnectez-vous 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 devrez peut-être vous reconnecter occasionnellement dans une session PowerShell.

Remarque

Si le service de protection n’est pas encore activé, vous pouvez le faire une fois que vous êtes connecté au service, à l’aide de l’applet de commande Enable-AipService .