Get-AipServiceTemplateProperty
Obtiene las propiedades de una plantilla de protección para Azure Information Protection.
Syntax
Get-AipServiceTemplateProperty
-TemplateId <Guid>
[-Names]
[-Descriptions]
[-RightsDefinitions]
[-ContentExpirationOption]
[-ContentExpirationDate]
[-ContentValidityDuration]
[-LicenseValidityDuration]
[-ReadOnly]
[-Status]
[-ScopedIdentities]
[-EnableInLegacyApps]
[<CommonParameters>]
Description
El cmdlet Get-AipServiceTemplateProperty obtiene las propiedades especificadas de una plantilla de protección para Azure Information Protection, mediante el parámetro TemplateId.
También se puede ver información de configuración similar en el Azure Portal, pero este cmdlet también incluye el GUID de plantilla.
Puede consultar las propiedades de una plantilla predeterminada o una plantilla personalizada. Para más información sobre las plantillas personalizadas, incluido cómo configurarlas en el Azure Portal, consulte Configuración y administración de plantillas para Azure Information Protection.
¿Uso del cliente de etiquetado unificado de Azure Information Protection?
El cliente de etiquetado unificado de Azure Information Protection usa plantillas de protección indirectamente. Si tiene el cliente de etiquetado unificado, se recomienda usar cmdlets basados en etiquetas en lugar de modificar las plantillas de protección directamente.
Para obtener más información, vea Crear y publicar etiquetas de confidencialidad en la documentación de Microsoft 365.
Ejemplos
Ejemplo 1: Obtener la descripción y los derechos de uso de una plantilla
PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitions
Este comando obtiene la descripción y los derechos de uso de todos los usuarios o grupos configurados para la plantilla de protección especificada.
Ejemplo 2: Para todas las plantillas, obtenga el nombre, los derechos de uso, si una plantilla predeterminada y si se publica o archiva.
PS C:\>$templates = Get-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}
El primer comando obtiene todos los identificadores de plantilla y los almacena en una variable. A continuación, el segundo comando usa esta variable para obtener el nombre de la plantilla, los derechos de uso, ya sea de solo lectura (True para una plantilla predeterminada, False para una plantilla personalizada) y el estado (publicado o archivado) de cada plantilla.
Parámetros
-ContentExpirationDate
Enumera la fecha en la que expira el contenido protegido con la plantilla.
Use este parámetro solo si ContentExpirationOption está establecido en OnDate.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentExpirationOption
Obtiene el valor de configuración de expiración de contenido para el contenido que está protegido con la plantilla.
Se devuelve uno de los siguientes valores:
Never. Indica que el contenido está disponible de forma indefinida.
OnDate. Indica que el contenido expira en una determinada fecha fija.
AfterDays. Indica que el contenido está disponible durante el número señalado de días después de haberse protegido.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentValidityDuration
Enumera el número de días desde el día de protección después del cual expira el contenido protegido con la plantilla.
Use este parámetro solo si ContentExpirationOption está establecido en AfterDays.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Descriptions
Enumera las descripciones de la plantilla en todas las configuraciones regionales.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableInLegacyApps
Indica el comportamiento de una plantilla de departamento en aplicaciones que no admiten plantillas de departamento (consulte el parámetro ScopedIdentities ).
Si se establece en True y la plantilla es una plantilla de departamento, todos los usuarios que intentan proteger el contenido de una aplicación que no admite plantillas de departamento verán la plantilla y, por tanto, podrán seleccionarla, independientemente de si los usuarios son miembros del ámbito de destino de la plantilla o no.
Si se establece en False, ningún usuario ve y, por tanto, no puede seleccionar la plantilla en aplicaciones que no admiten plantillas de departamento, incluso si los usuarios son miembros del ámbito de destino de la plantilla.
Esta configuración no tiene ningún efecto en las plantillas que no son plantillas de departamento ni en las aplicaciones compatibles con estas plantillas de forma nativa.
Este parámetro es funcionalmente el equivalente de la casilla Mostrar esta plantilla a todos los usuarios cuando las aplicaciones no admiten la identidad de usuario al configurar APPLICATION COMPATIBILITY en el Portal de Azure clásico (ahora retirado). No hay ninguna configuración equivalente en el Azure Portal.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseValidityDuration
Muestra el número de días en que se puede acceder al contenido sin conexión después de que se adquiera una licencia para consumirlo.
-1 indica acceso ilimitado.
0 indica que se debe obtener una licencia para cada uso y que el contenido solo está disponible en línea.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Names
Enumera los nombres de la plantilla en todas las configuraciones regionales.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReadOnly
Indica si la plantilla es una plantilla predeterminada (True) y, por lo tanto, no se puede editar o eliminar, o una plantilla personalizada (False) y, por tanto, un administrador puede editarla o eliminarla.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RightsDefinitions
Enumera los derechos concedidos a usuarios o grupos para el contenido protegido con la plantilla.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScopedIdentities
Enumera por dirección correo electrónico (cuenta o grupo) a los usuarios que pueden ver (y, por lo tanto, seleccionar) plantillas de departamento desde las aplicaciones.
Para que los usuarios especificados vean las plantillas, la aplicación debe admitir plantillas de departamento o el parámetro EnableInLegacyApps debe establecerse en True.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Status
Estado de la plantilla:
-Las plantillas archivadas están disponibles para consumir contenido protegido previamente, pero no se muestran a los usuarios.
-Las plantillas publicadas están disponibles para los usuarios para proteger el contenido.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateId
Especifica el GUID de una plantilla de protección.
Puede usar el cmdlet Get-AipServiceTemplate para obtener el identificador de plantilla de todas las plantillas.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |