Get-Label
Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.
Use el cmdlet Get-Label para ver las etiquetas de confidencialidad de su organización.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Default (valor predeterminado)
Get-Label
[[-Identity] <ComplianceRuleIdParameter>]
[-IncludeDetailedLabelActions]
[-SkipValidations]
[-ReturnModernLabelScheme]
[-ValidateContentTypeRemoval]
[<CommonParameters>]
Description
Nota: Si su organización tiene más etiquetas de confidencialidad han 1000, la configuración de tiempo de espera establecida para la sesión de PowerShell puede causar problemas de rendimiento. Use el parámetro SkipValidations para recuperar etiquetas de forma más eficaz.
Para usar este cmdlet en Security & Compliance PowerShell, debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Ejemplos
Ejemplo 1
Get-Label
En este ejemplo se devuelve una lista de resumen de todas las etiquetas de confidencialidad de la organización.
Ejemplo 2
Get-Label -Identity "Engineering Group" | Format-List
En este ejemplo se devuelve información detallada de la etiqueta de confidencialidad denominada Grupo de ingeniería.
Parámetros
-Identity
Aplicable: Cumplimiento de & de seguridad
El parámetro Identity especifica la etiqueta de confidencialidad que desea ver. Puede usar cualquier valor que identifique de forma exclusiva la etiqueta. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.
Propiedades de parámetro
| Tipo: | ComplianceRuleIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-IncludeDetailedLabelActions
Aplicable: Cumplimiento de & de seguridad
El parámetro IncludeDetailedLabelActions especifica si se expanden las acciones de etiqueta en propiedades para mejorar la legibilidad. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReturnModernLabelScheme
Aplicable: Cumplimiento de & de seguridad
{{ Fill ReturnModernLabelScheme Description }}
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SkipValidations
Aplicable: Cumplimiento de & de seguridad
El modificador SkipValidations especifica si se debe omitir la recuperación de propiedades de cifrado configuradas en etiquetas de confidencialidad. No es necesario especificar un valor con este modificador.
Las organizaciones con más de 1000 etiquetas pueden usar este modificador para reducir el tiempo necesario para capturar las etiquetas, lo que ayuda a evitar problemas de tiempo de espera con Get-Label cmdlet.
Nota: El uso de este modificador no omite las validaciones cuando se recuperan etiquetas. Solo omite la recuperación de las propiedades de la plantilla de cifrado si están configuradas para una etiqueta. Puede obtener esas propiedades individualmente mediante el parámetro Identity en el comando Get-Label.
Este modificador no afecta a la aplicación de etiquetas ni a la distribución. La limitación solo existe cuando se capturan etiquetas para operaciones CRUD.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ValidateContentTypeRemoval
Aplicable: Cumplimiento de & de seguridad
{{ Fill ValidateContentType Descripción deremoval }}
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.