Set-AutoSensitivityLabelPolicy

Este cmdlet solo está disponible en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.

Use el cmdlet Set-AutoSensitivityLabelPolicy para modificar las directivas de etiquetado automático en 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-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-ApplySensitivityLabel <String>]
   [-AutoEnableAfter <Timespan>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-SpoAipIntegrationEnabled <Boolean>]
   [-StartSimulation <Boolean>]
   [-SystemOperation]
   [-WhatIf]
   [<CommonParameters>]
Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-Mode <PolicyMode>]
   [-WhatIf]
   [<CommonParameters>]
Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Confirm]
   [-Mode <PolicyMode>]
   [-RetryDistribution]
   [-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.

Ejemplos

Ejemplo 1

Set-AutoSensitivityLabelPolicy -Identity "Main PII" -AddSharePointLocation "https://my.url1","https://my.url2" -AddOneDriveLocation "https://my.url3","https://my.url4"

En este ejemplo se agregan las direcciones URL especificadas a SharePoint Online y OneDrive para la Empresa ubicaciones para la directiva de etiquetado automático denominada Main PII sin afectar a los valores de dirección URL existentes.

Parámetros

-AddExchangeLocation

El parámetro AddExchangeLocation agrega mensajes de correo electrónico a la directiva si aún no están incluidos. El valor válido para este parámetro es All.

Si la directiva aún no incluye mensajes de correo electrónico (en la salida del cmdlet Get-AutoSensitivityLabelPolicy, el valor de la propiedad ExchangeLocation está en blanco), puede usar este parámetro en los procedimientos siguientes:

  • Si usa -AddExchangeLocation All por sí mismo, la directiva se aplica al correo electrónico de todos los usuarios internos.

  • Para incluir el correo electrónico de usuarios internos o externos específicos en la directiva, use -AddExchangeLocation All con el parámetro ExchangeSender en el mismo comando. En la directiva solo se incluye el correo electrónico de los usuarios especificados.

  • Para incluir correo electrónico de miembros de grupo específicos en la directiva, use -AddExchangeLocation All con el parámetro ExchangeSenderMemberOf en el mismo comando. En la directiva solo se incluye el correo electrónico de los miembros de los grupos especificados.

  • Para excluir el correo electrónico de usuarios internos específicos de la directiva, use -AddExchangeLocation All con el parámetro ExchangeSenderException en el mismo comando. Solo se excluye de la directiva el correo electrónico de los usuarios especificados.

  • Para excluir el correo electrónico de miembros de grupo específicos de la directiva, use -AddExchangeLocation All con el parámetro ExchangeSenderMemberOfException en el mismo comando. Solo se excluye de la directiva el correo electrónico de los miembros de los grupos especificados.

No se pueden especificar inclusiones y exclusiones en la misma directiva.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddOneDriveLocation

El parámetro AddOneDriveLocation especifica los sitios OneDrive para la Empresa que se van a agregar a la lista de sitios incluidos cuando no se usa el valor All para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddOneDriveLocationException

El parámetro AddOneDriveLocationException especifica los sitios OneDrive para la Empresa que se van a agregar a la lista de sitios excluidos cuando se usa el valor All para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocation

El parámetro AddSharePointLocation especifica los sitios de SharePoint Online que se van a agregar a la lista de sitios incluidos cuando no se usa el valor All para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

Los sitios de SharePoint Online no se pueden agregar a la directiva hasta que se hayan indexado.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocationException

El parámetro AddSharePointLocationException especifica los sitios de SharePoint Online que se van a agregar a la lista de sitios excluidos cuando se usa el valor All para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplySensitivityLabel

El parámetro ApplySensitivityLabel selecciona la etiqueta que se va a usar para la directiva. Esto invalidará la etiqueta anterior en la directiva.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AutoEnableAfter

El parámetro AutoEnableAfter permite activar automáticamente la directiva después de un período de tiempo establecido en la simulación. El período de tiempo se reinicia cada vez que se modifica la directiva o cuando se desencadena una simulación.

Para especificar un valor, escríbalo como un intervalo de tiempo: dd.hh:mm:ss donde dd = días, hh = horas, mm = minutos y ss = segundos.

Un valor válido está comprendido entre 1 hora y 25 días.

Debe usar este parámetro con el parámetro -StartSimulation.

Type:System.TimeSpan
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

-Enabled

El parámetro Enabled habilita o deshabilita la directiva. Los valores admitidos son:

  • $true: la directiva está habilitada. Este es el valor predeterminado.
  • $true: la directiva está habilitada. Es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSender

El parámetro ExchangeSender especifica los usuarios cuyo correo electrónico se incluye en la directiva. Especifique los usuarios por dirección de correo electrónico. Puede especificar direcciones de correo electrónico internas o externas.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Para usar este parámetro, una de las siguientes instrucciones debe ser true:

  • La directiva ya incluye mensajes de correo electrónico (en la salida del cmdlet Get-AutoSensitivityLabelPolicy, el valor de la propiedad ExchangeLocation es All).
  • Use -AddExchangeLocation All en el mismo comando con este parámetro.

No se puede usar este parámetro con los parámetros ExchangeSenderException o ExchangeSenderMemberOfException.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderException

El parámetro ExchangeSenderException especifica los usuarios internos cuyo correo electrónico se excluye de la directiva. Los usuarios se identifican por dirección de correo electrónico.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Para usar este parámetro, una de las siguientes instrucciones debe ser true:

  • La directiva ya incluye mensajes de correo electrónico (en la salida de Get-AutoSensitivityLabelPolicy, el valor de la propiedad ExchangeLocation es All).
  • Use -AddExchangeLocation All en el mismo comando con este parámetro.

No se puede usar este parámetro con los parámetros ExchangeSender o ExchangeSenderMemberOf.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderMemberOf

El parámetro ExchangeSenderMemberOf especifica los grupos de distribución o los grupos de seguridad habilitados para correo que se incluirán en la directiva (el correo electrónico de los miembros del grupo se incluye en la directiva). Los grupos se identifican por dirección de correo electrónico.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Para usar este parámetro, una de las siguientes instrucciones debe ser true:

  • La directiva ya incluye mensajes de correo electrónico (en la salida de Get-AutoSensitivityLabelPolicy, el valor de la propiedad ExchangeLocation es All).
  • Use -AddExchangeLocation All en el mismo comando con este parámetro.

No se puede usar este parámetro con los parámetros ExchangeSenderException o ExchangeSenderMemberOfException.

No se puede usar este parámetro para especificar Grupos de Microsoft 365.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderMemberOfException

El parámetro ExchangeSenderMemberOfException especifica los grupos de distribución o los grupos de seguridad habilitados para correo que se excluirán de la directiva (el correo electrónico de los miembros del grupo se excluye de la directiva). Los grupos se identifican por dirección de correo electrónico.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Para usar este parámetro, una de las siguientes instrucciones debe ser true:

  • La directiva ya incluye mensajes de correo electrónico (en la salida de Get-AutoSensitivityLabelPolicy, el valor de la propiedad ExchangeLocation es All).
  • Use -AddExchangeLocation All en el mismo comando con este parámetro.

No se puede usar este parámetro con los parámetros ExchangeSender o ExchangeSenderMemberOf.

No se puede usar este parámetro para especificar Grupos de Microsoft 365.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExternalMailRightsManagementOwner

El parámetro ExternalMailRightsManagementOwner especifica la dirección de correo electrónico de un buzón de usuario que se usa para cifrar los mensajes de correo electrónico entrantes de remitentes externos mediante RMS.

Este parámetro solo funciona en ubicaciones de Exchange y la directiva debe aplicar una etiqueta que tenga una acción de cifrado.

Para borrar una dirección de correo electrónico existente, use el valor $null.

Type:SmtpAddress
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 de etiquetado automático que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
Type:PolicyIdParameter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-Mode

El parámetro Mode especifica el nivel de acción y notificación de la directiva de etiquetado automático. Los valores admitidos son:

  • Habilitar: la directiva está habilitada para acciones y notificaciones.
  • Enable: se habilita la directiva para las notificaciones y acciones. Este es el valor predeterminado.
  • TestWithNotifications: no se admite.
  • TestWithoutNotifications: modo de auditoría en el que no se realizan acciones y no se envían notificaciones (modo de prueba).
Type:PolicyMode
Accepted values:Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-OverwriteLabel

El parámetro OverwriteLabel especifica si se va a sobrescribir una etiqueta manual. Los valores admitidos son:

  • $true: Sobrescriba la etiqueta manual.
  • $false: no sobrescriba la etiqueta manual. Este es el valor predeterminado.

Este parámetro solo funciona en ubicaciones de Exchange.

Type:Boolean
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

-PolicyTemplateInfo

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

-Priority

El parámetro Priority especifica un valor de prioridad para la directiva que determina el orden del procesamiento de directivas. Un valor entero inferior indica una prioridad mayor, el valor 0 es la prioridad más alta y las directivas no pueden tener el mismo valor de prioridad.

Los valores válidos y el valor predeterminado de este parámetro dependen del número de directivas existentes. Por ejemplo, si hay 5 directivas existentes:

  • Los valores de prioridad válidos para las 5 directivas existentes son de 0 a 4.
  • Los valores de prioridad válidos para una nueva directiva 6 son de 0 a 5.
  • El valor predeterminado de una nueva 6ª directiva es 5.

Si modifica el valor de prioridad de una directiva, la posición de la directiva en la lista cambia para que coincida con el valor de prioridad especificado. En otras palabras, si establece el valor de prioridad de una directiva en el mismo valor que una directiva existente, el valor de prioridad de la directiva existente y todas las demás directivas de prioridad inferior después de que se aumente en 1.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveExchangeLocation

El parámetro RemoveExchangeLocation quita los mensajes de correo electrónico de la directiva si ya están incluidos. El valor válido para este parámetro es All.

Si la directiva ya incluye mensajes de correo electrónico (en la salida del cmdlet Get-AutoSensitivityLabelPolicy, el valor de la propiedad ExchangeLocation es All), puede usar -RemoveExchangeLocation All para evitar que la directiva se aplique a los mensajes de correo electrónico.

No puede usar este parámetro si cualquiera de las reglas asociadas usa el correo electrónico (el valor Exchange).

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveOneDriveLocation

El parámetro RemoveOneDriveLocation especifica los sitios de OneDrive para la Empresa que se van a quitar de la lista de sitios incluidos cuando no se usa el valor All para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

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 RemoveOneDriveLocationException especifica los sitios OneDrive para la Empresa que se van a quitar de la lista de sitios excluidos cuando se usa el valor All para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocation

El parámetro RemoveSharePointLocation especifica los sitios de SharePoint Online que se van a quitar de la lista de sitios incluidos cuando no se usa el valor All para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocationException

El parámetro RemoveSharePointLocationException especifica los sitios de SharePoint Online que se van a quitar de la lista de sitios excluidos cuando se usa el valor All para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

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 redistribuye la directiva a todas las ubicaciones OneDrive para la Empresa y SharePoint 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

-SpoAipIntegrationEnabled

{{ Fill SpoAipIntegrationEnabled Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-StartSimulation

Use el parámetro StartSimulation para reiniciar la simulación para obtener resultados actualizados. Los valores admitidos son:

  • $true: reinicie la simulación para obtener resultados actualizados.
  • $false: este es el valor predeterminado
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SystemOperation

{{ Fill SystemOperation Description }}

Type:SwitchParameter
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