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.

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

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.