Get-AipServiceTemplateProperty
Obtiene las propiedades de una plantilla de protección para Azure Information Protection.
Sintaxis
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 -RightsDefinitionsEste 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Descriptions
Enumera las descripciones de la plantilla en todas las configuraciones regionales.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Names
Enumera los nombres de la plantilla en todas las configuraciones regionales.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RightsDefinitions
Enumera los derechos concedidos a usuarios o grupos para el contenido protegido con la plantilla.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |