Instalación del módulo de PowerShell AIPService

Artículo
12/27/2023

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

Puede usar este módulo de PowerShell para administrar el servicio de protección (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 Information Protection admite scripts para la automatización o puede ser necesario para escenarios de configuración avanzados. Para más información acerca de las tareas y configuraciones de administración que admite el módulo, consulte Administración de la protección de Azure Information Protection 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 protección de Azure Information Protection.

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 existente. 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 Nota: Esta versión de Microsoft .NET Framework se incluye con los sistemas operativos posteriores, por lo que solo debería tener que instalarlo manualmente si el sistema operativo cliente es inferior a Windows 8.0 o el sistema operativo servidor es inferior a Windows Server 2012. Si la versión mínima de Microsoft .NET Framework 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 la seguridad y el cumplimiento: descripciones del servicio.

Si tiene el módulo AADRM instalado

El módulo AIPService reemplaza al módulo anterior, AADRM. Si tiene instalado el módulo anterior, desinstálelo e 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. Sin embargo, planee actualizar estas referencias antes de que el módulo anterior no sea compatible. La compatibilidad con el módulo AADRM finalizará el 15 de julio de 2020.

Si instaló el módulo AADRM desde la 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 Programas y características para desinstalar la Administración de Windows Azure AD Rights Management.

Instalación del módulo AIPService

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

Para instalar el módulo AIPService desde la 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 la Galería de PowerShell, visite la página de 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 la Galería de PowerShell como repositorio de confianza mediante el comando Set-PSRepository -Name PSGallery -InstallationPolicy Trusted y 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 comando Get-Help <cmdlet_name> 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 de protección de Azure Information Protection mediante PowerShell

Para poder ejecutar los comandos que configuran el servicio de protección, debe conectarse al servicio mediante el cmdlet Connect-AipService.

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