Set-LabelPolicy
Este cmdlet solo funciona en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.
Use el cmdlet Set-Label para modificar las directivas de etiqueta 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.
Syntax
Set-LabelPolicy
[-Identity] <PolicyIdParameter>
-RetryDistribution
[-AddLabels <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Confirm]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PreviousLabelPolicy <PolicyIdParameter>]
[-RemoveLabels <MultiValuedProperty>]
[<CommonParameters>]
Set-LabelPolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddLabels <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-AddOneDriveLocation <MultiValuedProperty>]
[-AddOneDriveLocationException <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-AddSharePointLocationException <MultiValuedProperty>]
[-AddSkypeLocation <MultiValuedProperty>]
[-AddSkypeLocationException <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveLabels <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RemoveOneDriveLocation <MultiValuedProperty>]
[-RemoveOneDriveLocationException <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <MultiValuedProperty>]
[-RemoveSharePointLocationException <MultiValuedProperty>]
[-RemoveSkypeLocation <MultiValuedProperty>]
[-RemoveSkypeLocationException <MultiValuedProperty>]
[<CommonParameters>]
Set-LabelPolicy
[-Identity] <PolicyIdParameter>
[-AddLabels <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-Force]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PreviousLabelPolicy <PolicyIdParameter>]
[-RemoveLabels <MultiValuedProperty>]
[-Setting <PswsHashtable>]
[-Settings <PswsHashtable>]
[-WhatIf]
[<CommonParameters>]
Description
Para usar este cmdlet en PowerShell de cumplimiento de seguridad & , debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Nota: No use un comando de Foreach-Object canalizar al agregar o quitar ubicaciones de ámbito: "Value1","Value2",..."ValueN" | Foreach-Object {Set-LabelPolicy -Identity "Global Policy" -RemoveExchangeLocation $_ }
.
Ejemplos
Ejemplo 1
Set-LabelPolicy -Identity "Global Policy" -AdvancedSettings @{EnableCustomPermissions="False"}
En este ejemplo se configura la configuración avanzada especificada para el nombre de directiva de etiqueta de confidencialidad Directiva global.
Parámetros
-AddExchangeLocation
El parámetro AddExchangeLocation especifica los buzones que se van a agregar a la lista de buzones incluidos cuando no se usa el valor All para el parámetro ExchangeLocation. Un valor válido es un buzón.
Para especificar el buzón, puede usar cualquier valor que lo identifique de forma única. Por ejemplo:
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddExchangeLocationException
El parámetro AddExchangeLocationException especifica los buzones que se van a agregar a la lista de buzones excluidos cuando se usa el valor All para el parámetro ExchangeLocation. Un valor válido es un buzón.
Para especificar el buzón, puede usar cualquier valor que lo identifique de forma única. Por ejemplo:
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddLabels
El parámetro AddLabels especifica las etiquetas de confidencialidad que desea agregar a la directiva. Puede usar cualquier valor que identifique de forma exclusiva la etiqueta. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddModernGroupLocation
El parámetro AddModernGroupLocation especifica el Grupos de Microsoft 365 que se va a agregar a la lista de Grupos de Microsoft 365 incluidas. Para identificar el grupo de Microsoft 365, debe usar la dirección SMTP principal.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddModernGroupLocationException
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddOneDriveLocation
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddOneDriveLocationException
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddPublicFolderLocation
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddSharePointLocation
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddSharePointLocationException
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddSkypeLocation
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AddSkypeLocationException
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-AdvancedSettings
El parámetro AdvancedSettings habilita características y funcionalidades específicas del cliente para la directiva de etiquetas de confidencialidad.
Especifique este parámetro con la identidad (nombre o GUID) de la directiva, con pares clave-valor en una tabla hash. Para quitar una configuración avanzada, use la misma sintaxis de parámetro AdvancedSettings, pero especifique un valor de cadena null.
La mayoría de la configuración que configure con este parámetro solo se admite en Azure Information Protection cliente de etiquetado unificado y no en aplicaciones de Office que admiten el etiquetado integrado. Para obtener instrucciones, consulte Configuraciones personalizadas para azure Information Protection cliente de etiquetado unificado.
Configuración admitida para el etiquetado integrado:
AttachmentAction: los correos electrónicos no etiquetados heredan la etiqueta de prioridad más alta de los datos adjuntos de archivos. Establezca el valor en Automático (para aplicar automáticamente la etiqueta) o Recomendado (como aviso recomendado al usuario. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}
. Para obtener más información sobre esta opción de configuración, consulte Configuración de la herencia de etiquetas a partir de datos adjuntos de correo electrónico.EnableAudit: impedir que las aplicaciones de Office envíen datos de etiquetas de confidencialidad a soluciones de auditoría de Microsoft 365. Aplicaciones compatibles: Word, Excel y PowerPoint en Windows (versión 2201+), macOS (versión 16.57+), iOS (versión 2.57+) y Android (versión 16.0.14827+); Outlook en Windows (versión 2201+), Outlook en la Web y la implementación en macOS, iOS y Android. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}
.DisableMandatoryInOutlook: las aplicaciones de Outlook que admiten esta configuración excluyen los mensajes de Outlook del etiquetado obligatorio. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}
. Para obtener más información sobre esta opción de configuración, vea Opciones específicas de Outlook para etiquetas predeterminadas y etiquetado obligatorio.OutlookDefaultLabel: las aplicaciones de Outlook que admiten esta configuración aplican una etiqueta predeterminada o ninguna etiqueta. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}
. Para obtener más información sobre esta opción de configuración, vea Opciones específicas de Outlook para etiquetas predeterminadas y etiquetado obligatorio.TeamworkMandatory: las aplicaciones de Outlook y Teams que admiten esta configuración pueden habilitar o deshabilitar el etiquetado obligatorio para las reuniones. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}
. Para obtener más información sobre el etiquetado de reuniones, consulte Uso de etiquetas de confidencialidad para proteger elementos de calendario, reuniones de Teams y chat.teamworkdefaultlabelid: las aplicaciones de Outlook y Teams que admiten esta configuración aplican una etiqueta predeterminada o ninguna etiqueta para las reuniones. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}
. Para obtener más información sobre el etiquetado de reuniones, consulte Uso de etiquetas de confidencialidad para proteger elementos de calendario, reuniones de Teams y chat.HideBarByDefault: para las aplicaciones de Office que admiten la barra de confidencialidad, no muestre el nombre de la etiqueta de confidencialidad en el título de la barra de ventana para que haya más espacio para mostrar nombres de archivo largos. Solo se mostrará el icono de etiqueta y el color (si está configurado). Los usuarios no pueden revertir esta configuración en la aplicación. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}
Además, para Power BI:
powerbimandatory: etiquetado obligatorio para Power BI. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}
. Para obtener más información sobre esta opción de configuración, consulte Directiva de etiquetas obligatorias para Power BI.powerbidefaultlabelid: etiqueta predeterminada para el contenido de Power BI. Ejemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}
. Para obtener más información sobre esta opción de configuración, consulte Directiva de etiquetas predeterminada para Power BI.
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Comment
El parámetro Comment especifica un comentario opcional. Si especifica un valor que contenga espacios, escríbalo entre comillas ("), por ejemplo: "Esto es una nota del administrador".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Confirm
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false
. - La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Force
El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.
Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Identity
El parámetro Identity especifica la directiva que desea ver. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Type: | PolicyIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-MigrationId
Este parámetro está reservado para uso interno de Microsoft.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-NextLabelPolicy
El parámetro NextLabelPolicy actualiza el orden de la directiva, por lo que la directiva especificada por este parámetro es después de la directiva actual que está modificando. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Type: | PolicyIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PolicyRBACScopes
{{ Fill PolicyRBACScopes Description }}
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PreviousLabelPolicy
El parámetro PreviousLabelPolicy actualiza el orden de la directiva, por lo que la directiva especificada por este parámetro es anterior a la directiva actual que está modificando. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Type: | PolicyIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveExchangeLocation
El parámetro RemoveExchangeLocation especifica los buzones que se van a quitar de la lista de buzones incluidos cuando no se usa el valor All para el parámetro ExchangeLocation. Los valores admitidos son:
- El parámetro ExchangeLocation especifica los buzones de correo que se incluirán en la directiva. Los valores válidos son:
- Un buzón de correo
El valor All para todos los buzones. Solo puede utilizar este valor por sí mismo.
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveExchangeLocationException
El parámetro RemoveExchangeLocationException especifica los buzones que se van a quitar de la lista de buzones excluidos cuando se usa el valor All para el parámetro ExchangeLocation. Los valores admitidos son:
- El parámetro ExchangeLocation especifica los buzones de correo que se incluirán en la directiva. Los valores válidos son:
- Un buzón de correo
El valor All para todos los buzones. Solo puede utilizar este valor por sí mismo.
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveLabels
El parámetro RemoveLabels especifica las etiquetas de confidencialidad que desea quitar de la directiva. Puede usar cualquier valor que identifique de forma exclusiva la etiqueta. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveModernGroupLocation
El parámetro RemoveModernGroupLocation especifica el Grupos de Microsoft 365 que se va a quitar de la lista de grupos incluidos. Para identificar el grupo de Microsoft 365, debe usar la dirección SMTP principal.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveModernGroupLocationException
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveOneDriveLocation
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveOneDriveLocationException
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemovePublicFolderLocation
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveSharePointLocation
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveSharePointLocationException
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveSkypeLocation
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RemoveSkypeLocationException
Este parámetro está reservado para uso interno de Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RetryDistribution
El modificador RetryDistribution especifica si se va a redistribuir la directiva a todas las ubicaciones Exchange Online. No es necesario especificar un valor con este modificador.
No se incluyen en el reintento aquellas ubicaciones cuyas distribuciones iniciales fueron correctas. Cuando se usa este modificador, los errores de distribución de directivas se notifican.
Nota: Dado que el proceso de reintento de distribución es una operación significativa, ejecútelo solo si es necesario y para una directiva a la vez. No está pensado para ejecutarse cada vez que se actualiza una directiva. Si ejecuta un script para actualizar varias directivas, espere hasta que la distribución de directivas se realice correctamente antes de volver a ejecutar el comando para la siguiente directiva.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Setting
Este parámetro está reservado para uso interno de Microsoft.
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Settings
Este parámetro está reservado para uso interno de Microsoft.
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
El modificador WhatIf no funciona en PowerShell de cumplimiento de seguridad & .
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |