Compartir a través de

Get-AipServiceTemplateProperty

  • Referencia
Módulo:
AIPService

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 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 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, consulte 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, tanto si es de solo lectura (True para una plantilla predeterminada, False para una plantilla personalizada) y el estado (Publicado o Archivado) para 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 la configuración de expiración del contenido para el contenido protegido con la plantilla.

Se devuelve uno de los siguientes valores:

  • nunca. Indica que el contenido está disponible indefinidamente.

  • onDate. Indica que el contenido expira en una fecha fija determinada.

  • AfterDays. Indica que el contenido está disponible para el número indicado de días después de que esté 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 del 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 y tampoco tiene ningún efecto en las aplicaciones que admiten de forma nativa plantillas de departamento.

Este parámetro es funcionalmente el equivalente de la Mostrar esta plantilla a todos los usuarios cuando las aplicaciones no admiten la identidad de usuario casilla al configurar APPLICATION COMPATIBILITY en el Portal de Azure clásico (ahora retirado). No hay ninguna configuración equivalente en Azure Portal.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LicenseValidityDuration

Enumera el número de días que el contenido es accesible sin conexión después de adquirir una licencia para consumirlo.

-1 indica acceso ilimitado.

0 indica que se debe obtener una licencia para cada uso y que ese 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 tanto, no se puede editar ni eliminar, o una plantilla personalizada (False) y, por tanto, un administrador puede editar o eliminar.

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 los usuarios por dirección de correo electrónico (cuenta o grupo) que pueden ver y, por tanto, seleccionar plantillas de departamento de 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:

- plantillas de archivadas están disponibles para consumir contenido protegido previamente, pero no se muestran a los usuarios.

- plantillas de 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 de 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