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 de han 1000 etiquetas de confidencialidad, la configuración de tiempo de espera establecida para la sesión de Powershell puede provocar 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 resumida 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 Engineering Group.
Parámetros
-Identity
Aplicable: Seguridad & cumplimiento
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 para el parámetro Identidad sean precisas y no contengan 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: Seguridad & cumplimiento
El parámetro IncludeDetailedLabelActions especifica si se van a expandir 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: Seguridad & cumplimiento
{{ 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: Seguridad & cumplimiento
El modificador SkipValidations especifica si se omite la recuperación de las propiedades de cifrado configuradas en las 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 recuperes 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 o distribución de etiquetas. La limitación existe solo 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: Seguridad & cumplimiento
{{ Fill ValidateContentTypeRemoval 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 |
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.