Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Use la siguiente información para ayudarle a instalar el módulo de PowerShell para el servicio de cifrado de administración de derechos de Azure desde Microsoft Purview 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 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 tabla siguiente. PowerShell para el servicio Azure Rights Management admite secuencias de comandos 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 configuraciones que admite el módulo AIPService, 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 AIPService PowerShell para el servicio de cifrado de Azure Rights Management.
| Requisito | Más información |
|---|---|
| Versiones de PowerShell compatibles | Windows PowerShell 5.1 o PowerShell 7.4 y versiones posteriores. Puede confirmar la versión que está ejecutando escribiendo $PSVersionTable una sesión de PowerShell. La PSEdition propiedad se muestra Desktop para Windows PowerShell y Core para PowerShell 7. Para instalar PowerShell 7, consulte Instalación de PowerShell en Windows. PowerShell 7 requiere la versión 3.1.0.0 o posterior de AIPService. Las versiones anteriores del módulo solo admiten Windows PowerShell. |
| Versión mínima de .NET | Windows PowerShell 5.1 requiere Microsoft .NET Framework 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 utiliza el módulo AIPService. PowerShell 7.4 y versiones posteriores incluyen la versión de .NET que requiere el módulo, por lo que no es necesaria una instalación independiente. |
| Licencia necesaria | Debe tener una licencia de producto para usar esta característica. Para obtener más información, consulte la guía de licencias de Microsoft 365 para la seguridad & el cumplimiento: descripciones de servicio. |
Ediciones de PowerShell
La versión 3.1.0.0 de AIPService admite ambas ediciones de PowerShell en Windows desde un único paquete:
| Edición | Host | Tiempo de ejecución |
|---|---|---|
| Escritorio | Windows PowerShell 5.1 | .NET Framework 4.8 |
| Incorporación principal | PowerShell 7.4 y versiones posteriores | .NET 8 |
El módulo selecciona automáticamente la edición correcta al importarla, de modo que el mismo Install-Module comando funciona en ambos hosts. Los nombres de cmdlet, los parámetros y la salida son los mismos en ambas ediciones.
El inicio de sesión interactivo difiere entre las dos ediciones. Windows PowerShell 5.1 inicia sesión a través de una vista web incrustada, mientras que PowerShell 7 usa el explorador web predeterminado y una dirección de bucle invertido local. En un equipo que no tenga un explorador predeterminado disponible, como una instalación de Server Core, o en una sesión remota, use en su lugar la autenticación basada en certificados o de entidad de servicio. Para obtener más información, consulte Connect-AipService.
Para confirmar qué ediciones admite la versión instalada, ejecuta:
(Get-Module AIPService -ListAvailable).CompatiblePSEditions
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 AIPService tiene alias para los nombres de cmdlet en el módulo AADRM para que cualquier script existente siga funcionando. El módulo AADRM dejó de ser compatible 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 los procedimientos de eliminación de aplicaciones de Windows para desinstalar Windows Azure AD Rights Management Administration.
Cómo instalar el módulo AIPService
El módulo AIPService se encuentra 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 configuración de la Galería de PowerShell, incluida la instalación del módulo PowerShellGet y el proveedor de NuGet.
Para ver detalles acerca del módulo AIPService en la Galería de PowerShell, visite el paquete AIPService en la Galería de PowerShell.
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 acerca de 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 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 una versión anterior del módulo AIPService instalada desde la galería, actualícela a la última escribiendo:
Update-Module -Name AIPService
Nota:
Para usar el módulo en PowerShell 7, ejecute Install-Module -Name AIPService desde una sesión de PowerShell 7. Windows PowerShell y PowerShell 7 usan carpetas de módulos independientes por usuario, por lo que un módulo que se instaló para el usuario actual en Windows PowerShell no está disponible en PowerShell 7.
Pasos siguientes
En una sesión de PowerShell, confirme la versión del módulo instalado. Esta comprobación es especialmente importante si actualizaste desde una versión anterior:
(Get-Module AIPService -ListAvailable).Version
Nota:
Si (Get-Module AIPService -ListAvailable).Version se produce un error, 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 los principales escenarios de configuración compatibles con PowerShell: Administración del servicio Azure Rights Management mediante PowerShell
Para poder ejecutar los comandos que configuren 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éctese 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 necesite volver a conectarse ocasionalmente en una sesión de PowerShell.
Nota:
Si el servicio Azure Rights Management todavía no está activado, puede activarlo después de conectarse al servicio mediante el cmdlet Enable-AipService.