Compartir a través de


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