Instalación del módulo de PowerShell AIPService para el servicio Azure Right Management

Use la siguiente información para ayudarle a instalar el módulo de Windows PowerShell para el servicio de cifrado Azure Right Management desde Microsoft Purview Information Protection. El nombre de este módulo es AIPService y reemplaza a la versión anterior denominada AADRM.

Puede usar este módulo de PowerShell para administrar el servicio de cifrado de Azure Rights Management desde la línea de comandos mediante cualquier equipo Windows que tenga una conexión a Internet y que cumpla los requisitos previos enumerados en la sección siguiente. Windows PowerShell para Azure Rights Management admite scripting para la automatización o puede ser necesario para escenarios de configuración avanzada. Para obtener más información sobre las tareas de administración y las configuraciones que admite el módulo, consulte Administración del servicio Azure Rights Management mediante PowerShell.

Requisitos previos

En esta tabla se enumeran los requisitos previos para instalar y usar el módulo de PowerShell AIPService para el servicio de cifrado de Azure Rights Management.

Requisito	Más información
Versión mínima de Windows PowerShell	Versión 3.0 Puede confirmar la versión de Windows PowerShell que está ejecutando escribiendo $PSVersionTable en una sesión de PowerShell. Si necesita instalar una versión posterior de Windows PowerShell, consulte Actualización de Windows PowerShell existentes. Tenga en cuenta que el módulo de PowerShell AIPService solo admite Windows PowerShell. No se admite PowerShell 7.
Versión mínima de Microsoft .NET Framework	Versión 4.8 Esta versión mínima de Microsoft .NET Framework se incluye con los sistemas operativos posteriores, pero si aún no está instalada, puede descargar Microsoft .NET Framework 4.8. Esta versión mínima de Microsoft .NET Framework es necesaria para algunas de las clases que usa el módulo AIPService.
Licencia necesaria	Debe tener una licencia de producto para usar esta característica. Para obtener más información, consulte Guía de licencias de Microsoft 365 para el cumplimiento de & seguridad: descripciones del servicio.

Si tiene instalado el módulo AADRM

El módulo AIPService reemplaza al módulo anterior, AADRM. Si tiene instalado el módulo anterior, desinstálelo y, a continuación, instale el módulo AIPService.

El módulo más reciente tiene alias para los nombres de cmdlet del módulo anterior para que los scripts existentes sigan funcionando. El módulo anterior no es compatible el 15 de julio de 2020.

Si instaló el módulo AADRM desde el Galería de PowerShell, para desinstalarlo, inicie una sesión de PowerShell con la opción Ejecutar como administrador y escriba:

Uninstall-Module -Name AADRM

Si instaló el módulo AADRM con la herramienta de administración de Azure Rights Management, use los procedimientos de eliminación de aplicaciones de Windows para desinstalar Administración de derechos de Windows Azure AD.

Instalación del módulo AIPService

El módulo AIPService está en el Galería de PowerShell y no está disponible en el Centro de descarga de Microsoft.

Para instalar el módulo AIPService desde el Galería de PowerShell

Si no está familiarizado con la Galería de PowerShell, consulte Introducción a la Galería de PowerShell. Siga las instrucciones de los requisitos de la galería, que incluyen la instalación del módulo PowerShellGet y el proveedor de NuGet.

Para ver detalles sobre el módulo AIPService en el Galería de PowerShell, visite la página AIPService.

Para instalar el módulo AIPService, inicie una sesión de PowerShell con la opción Ejecutar como administrador y escriba:

Install-Module -Name AIPService

Si se le advierte sobre la instalación desde un repositorio que no es de confianza, puede presionar Y para confirmar. O bien, presione N y configure el Galería de PowerShell como un repositorio de confianza mediante el comando Set-PSRepository -Name PSGallery -InstallationPolicy Trusted y, a continuación, vuelva a ejecutar el comando para instalar el módulo AIPService.

Si tiene instalada una versión anterior del módulo AIPService desde la Galería, actualícela a la versión más reciente escribiendo:

Update-Module -Name AIPService

Pasos siguientes

En una sesión de Windows PowerShell, confirme la versión del módulo instalado. Esta comprobación es especialmente importante si ha actualizado desde una versión anterior:

(Get-Module AIPService –ListAvailable).Version

Nota:

Si se produce un error en este comando, ejecute primero Import-Module AIPService.

Para ver qué cmdlets están disponibles, escriba lo siguiente:

Get-Command -Module AIPService

Use el Get-Help <cmdlet_name> comando para ver la Ayuda de un cmdlet específico y use el parámetro -online para ver la ayuda más reciente en el sitio de documentación de Microsoft. Por ejemplo:

Get-Help Connect-AipService -online

Para más información:

• Lista completa de cmdlets disponibles: Módulo AIPService

• Lista de escenarios de configuración principales que admiten PowerShell: Administración del servicio Azure Rights Management mediante PowerShell

Para poder ejecutar los comandos que configuran el servicio Azure Rights Management, debe conectarse al servicio mediante el cmdlet Connect-AipService.

Cuando haya terminado de ejecutar los comandos de configuración, como procedimiento recomendado, desconécte del servicio mediante el cmdlet Disconnect-AipService . Si no se desconecta, la conexión se desconecta automáticamente después de un período de inactividad. Debido al comportamiento de desconexión automática, es posible que deba volver a conectarse ocasionalmente en una sesión de PowerShell.

Nota:

Si el servicio de Azure Rights Management aún no está activado, puede hacerlo después de conectarse al servicio mediante el cmdlet Enable-AipService.