Installation du module PowerShell AADRMInstalling the AADRM PowerShell module

S’applique à : Azure Information Protection, Office 365Applies to: Azure Information Protection, Office 365

Pour installer le module Windows PowerShell pour le service Azure Rights Management à partir Azure Information Protection, aidez-vous des informations suivantes.Use the following information to help you install the Windows PowerShell module for the Azure Rights Management service from Azure Information Protection. Le nom de ce module est AADRM.The name of this module is AADRM.

Vous pouvez utiliser ce module PowerShell pour administrer le service Azure Rights Management à partir de la ligne de commande avec un ordinateur qui a une connexion Internet et qui remplit les conditions préalables répertoriées dans la section suivante.You can use this PowerShell module to administer the Azure Rights Management service from the command line by using any computer that has an Internet connection and that meets the prerequisites listed in the next section. Windows PowerShell pour Gestion des droits AzureAzure Rights Management prend en charge les scripts d’automatisation ou peut être nécessaire pour les scénarios de configuration avancée.Windows PowerShell for Gestion des droits AzureAzure Rights Management supports scripting for automation or might be necessary for advanced configuration scenarios. Pour plus d’informations sur les tâches d’administration et les configurations prises en charge par le module, consultez Administration d’Azure Rights Management à l’aide de Windows PowerShell.For more information about the administration tasks and configurations that the module supports, see Administering Azure Rights Management by Using Windows PowerShell.

PrérequisPrerequisites

Le tableau ci-dessous répertorie les prérequis pour l’installation et l’utilisation du module PowerShell AADRM pour le service Azure Rights Management à partir d’Azure Information Protection.This table lists the prerequisites to install and use the AADRM PowerShell module for the Azure Rights Management service from Azure Information Protection.

Condition requiseRequirement Plus d’informationsMore information
Version minimale de Windows PowerShell : 3.0Minimum version of Windows PowerShell: 3.0 Vous pouvez vérifier la version de Windows PowerShell que vous exécutez en tapant $PSVersionTable dans une session PowerShell.You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a PowerShell session.

Si vous devez installer une version ultérieure de Windows PowerShell, consultez Mise à niveau de la version Windows PowerShell existante.If you need to install a later version of Windows PowerShell, see Upgrading existing Windows PowerShell.
Version minimale du Microsoft .NET Framework : 4.5Minimum version of the Microsoft .NET Framework: 4.5

Remarque : Cette version du Microsoft .NET Framework étant fournie avec les systèmes d’exploitation de version plus récente, une installation manuelle ne devrait être nécessaire que si le système d’exploitation de votre client est antérieur à Windows 8.0, ou si celui de votre serveur est antérieur à Windows Server 2012.Note: This version of the Microsoft .NET Framework is included with the later operating systems, so you should need to manually install it only if your client operating system is less than Windows 8.0 or your server operating system is less than Windows Server 2012.
Si la version minimale du Microsoft .NET Framework n’est pas installée, vous pouvez télécharger Microsoft .NET Framework 4.5.If the minimum version of the Microsoft .NET Framework is not already installed, you can download Microsoft .NET Framework 4.5.

Cette version minimale du Microsoft .NET Framework est requise pour certaines des classes utilisées par le module d’administration AADRM.This minimum version of the Microsoft .NET Framework is required for some of the classes that the AADRM module uses.

À compter de la version 2.5.0.0 du module AADRM, l’Assistant de connexion Microsoft Online Services n’est plus nécessaire.Starting with version 2.5.0.0 of the AADRM module, the Microsoft Online Services Sign-In Assistant is no longer required.

Note

Si vous avez installé une version du module AADRM avec l’outil d’administration d’Azure Rights Management, utilisez Programmes et fonctionnalités pour désinstaller Administration de Microsoft Azure AD Rights Management avant d’installer la version la plus récente du module AADRM à partir de PowerShell Gallery.If you installed a version of the AADRM module with the Azure Rights Management Administration Tool, use Programs and Features to uninstall Windows Azure AD Rights Management Administration before you install the latest version of the AADRM module from the PowerShell Gallery.

Comment installer le module AADRMHow to install the AADRM module

Le module AADRM ayant été déplacé vers PowerShell Gallery, il n’est plus disponible à partir du Centre de téléchargement Microsoft.The AADRM module has moved to the PowerShell Gallery and is no longer available from the Microsoft Download Center.

Si vous n’avez jamais utilisé PowerShell Gallery, consultez Bien démarrer avec PowerShell.If you're new to the PowerShell Gallery, see Get Started with the PowerShell Gallery. Suivez les instructions relatives à la configuration requise de la galerie, avec notamment l’installation du module PowerShellGet et du fournisseur NuGet.Follow the instructions for the gallery requirements, which include installing the PowerShellGet module and the NuGet provider.

Pour consulter des informations détaillées sur le module AADRM dans PowerShell Gallery, visitez la page AADRM.To see details about the AADRM module on the PowerShell Gallery, visit the AADRM page.

Pour installer le module AADRM, démarrez une session PowerShell avec l’option Exécuter en tant qu’administrateur, puis tapez :To install the AADRM module, start a PowerShell session with the Run as Administrator option, and type:

Install-Module -Name AADRM

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.If you are warned about installing from an untrusted repository, you can press Y to confirm. Ou bien, appuyez sur N et configurez PowerShell Gallery en tant que dépôt approuvé à l’aide de la commande Set-PSRepository -Name PSGallery -InstallationPolicy Trusted, puis réexécutez la commande pour installer le module AADRM.Or, press N and configure the PowerShell Gallery as a trusted repository by using the command Set-PSRepository -Name PSGallery -InstallationPolicy Trusted and then rerun the command to install the AADRM module.

Si une version antérieure du module AADRM a déjà été installée à partir de PowerShell Gallery, mettez-la à jour vers la dernière version en tapant :If you have a previous version of the AADRM module installed from the Gallery, update it to the latest by typing:

Update-Module -Name AADRM

Étapes suivantesNext steps

Dans une session Windows PowerShell, confirmez la version du module installé.In a Windows PowerShell session, confirm the version of the installed module. Cette vérification est particulièrement importante si vous avez mis à niveau à partir d’une version antérieure :This check is particularly important if you upgraded from an older version:

(Get-Module AADRM –ListAvailable).Version

Remarque : si cette commande échoue, exécutez d’abord Import-Module AADRM.Note: If this command fails, first run Import-Module AADRM.

Pour voir les applets de commande disponibles, tapez la commande suivante :To see which cmdlets are available, type the following:

Get-Command -Module AADRM

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.Use the Get-Help <cmdlet_name> command to see the Help for a specific cmdlet, and use the -online parameter to see the latest help on the Microsoft documentation site. Par exemple :For example:

Get-Help Connect-AadrmService -online

Pour plus d’informations :For more information:

Avant de pouvoir exécuter des commandes pour configurer le service Gestion des droits AzureAzure Rights Management, vous devez vous connecter au service à l’aide de l’applet de commande Connect-AadrmService.Before you can run any commands that configure the Gestion des droits AzureAzure Rights Management service, you must connect to the service by using the Connect-AadrmService cmdlet. Lorsque vous avez terminé l’exécution de vos commandes de configuration, nous vous conseillons de vous déconnecter du service à l’aide de l’applet de commande Disconnect-AadrmService.When you have finished running your configuration commands, as a best practice, disconnect from the service by using the Disconnect-AadrmService cmdlet. Si vous ne vous déconnectez pas, la connexion est interrompue automatiquement après une période d’inactivité.If you do not disconnect, the connection is automatically disconnected after a period of inactivity. En raison du comportement de déconnexion automatique, vous constaterez que vous devrez occasionnellement vous reconnecter à une session PowerShell.Because of the automatic disconnection behavior, you might find that you need to occasionally reconnect in a PowerShell session.

Note

Si le service Azure Rights Management n’est pas encore activé, vous pouvez le faire une fois connecté au service, à l’aide de l’applet de commande Enable-Aadrm.If the Azure Rights Management service is not yet activated, you can do this after you have connected to the service, by using the Enable-Aadrm cmdlet.

CommentairesComments

Avant de transmettre vos commentaires, nous vous demandons de consulter notre règlement interne.Before commenting, we ask that you review our House rules.