New-AutoSensitivityLabelPolicy

Módulo:

ExchangePowerShell

Se aplica a:

Security & Compliance

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

Use el cmdlet New-AutoSensitivityLabelPolicy para crear directivas de etiquetado automático en su organización. Cree reglas de directiva de etiquetado automático mediante el cmdlet New-AutoSensitivityLabelRule y asócielas a la directiva para completar la creación de la directiva.

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

New-AutoSensitivityLabelPolicy
   [-Name] <String>
   -ApplySensitivityLabel <String>
   [-Comment <String>]
   [-Confirm]
   [-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
   [-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
   [-ExchangeAdaptiveScopes <MultiValuedProperty>]
   [-ExchangeAdaptiveScopesException <MultiValuedProperty>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Locations <String>]
   [-Mode <PolicyMode>]
   [-OneDriveAdaptiveScopes <MultiValuedProperty>]
   [-OneDriveAdaptiveScopesException <MultiValuedProperty>]
   [-OneDriveLocation <MultiValuedProperty>]
   [-OneDriveLocationException <MultiValuedProperty>]
   [-OneDriveSharedBy <RecipientIdParameter[]>]
   [-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-SharePointAdaptiveScopes <MultiValuedProperty>]
   [-SharePointAdaptiveScopesException <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-SharePointLocationException <MultiValuedProperty>]
   [-UnifiedAuditLogEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

New-AutoSensitivityLabelPolicy -Name "GlobalPolicy" -Comment "Primary policy" -SharePointLocation "https://my.url","https://my.url2" -OneDriveLocation "https://my.url3","https://my.url4" -Mode TestWithoutNotifications -ApplySensitivityLabel "Test"

En este ejemplo se crea una directiva de etiquetado automático denominada GlobalPolicy para las ubicaciones de SharePoint Online y OneDrive para la Empresa especificadas con la etiqueta "Test". La nueva directiva tiene un comentario descriptivo y estará en modo de simulación durante la creación.

Parámetros

-ApplySensitivityLabel

El parámetro ApplySensitivityLabel especifica la etiqueta que se va a usar para la directiva de etiquetado automático.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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".

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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, los 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 otros cmdlets (por ejemplo, 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.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-ExceptIfOneDriveSharedBy

El parámetro ExceptIfOneDriveSharedBy especifica los usuarios que se excluirán de la directiva (los sitios de las cuentas de usuario OneDrive para la Empresa se incluyen en la directiva). Los usuarios se identifican por UPN (laura@contoso.onmicrosoft.com).

Para usar este parámetro, OneDrive para la Empresa sitios deben incluirse en la directiva (el valor del parámetro OneDriveLocation es All, que es el valor predeterminado).

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

No se puede usar este parámetro con el parámetro OneDriveSharedBy.

Tipo:	RecipientIdParameter[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-ExceptIfOneDriveSharedByMemberOf

{{ Fill ExceptIfOneDriveSharedByMemberOf Description }}

Tipo:	RecipientIdParameter[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-ExchangeAdaptiveScopes

{{ Fill ExchangeAdaptiveScopes Description }}

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-ExchangeAdaptiveScopesException

{{ Fill ExchangeAdaptiveScopesException Description }}

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-ExchangeLocation

El parámetro ExchangeLocation especifica si se deben incluir mensajes de correo electrónico en la directiva. El valor válido para este parámetro es All. Si no desea incluir mensajes de correo electrónico en la directiva, no use este parámetro (el valor predeterminado está en blanco o $null).

Puede usar este parámetro en los procedimientos siguientes:

• Si usa -ExchangeLocation 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 -ExchangeLocation 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 solo el correo electrónico de miembros de grupo específicos en la directiva, use -ExchangeLocation 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 -ExchangeLocation 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 solo el correo electrónico de miembros de grupo específicos de la directiva, use -ExchangeLocation 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.

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-ExchangeSender

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

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

Debe usar este parámetro con el parámetro ExchangeLocation.

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

Tipo:	SmtpAddress[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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 escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Debe usar este parámetro con el parámetro ExchangeLocation.

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

Tipo:	SmtpAddress[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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 escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Debe usar este parámetro con el parámetro ExchangeLocation.

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.

Tipo:	SmtpAddress[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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 escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".

Debe usar este parámetro con el parámetro ExchangeLocation.

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.

Tipo:	SmtpAddress[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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.

Tipo:	SmtpAddress
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-Locations

{{ Ubicaciones de relleno Descripción }}

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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. Este es el valor predeterminado.
• Enable: se habilita la directiva para las notificaciones y acciones. Este es el valor predeterminado.
• Disable: la directiva está deshabilitada.
• TestWithNotifications: no se realiza ninguna acción, pero se envían las notificaciones.

Tipo:	PolicyMode
Valores aceptados:	Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-Name

El parámetro Name especifica un nombre único para la directiva de etiquetado automático. Si el valor contiene espacios, incluya el valor entre comillas (").

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-OneDriveAdaptiveScopes

{{ Fill OneDriveAdaptiveScopes Description }}

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-OneDriveAdaptiveScopesException

{{ Fill OneDriveAdaptiveScopesException Description }}

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-OneDriveLocation

El parámetro OneDriveLocation especifica los sitios OneDrive para la Empresa que se van a incluir en la directiva. Identifique el sitio por su valor de dirección URL o use el valor All para incluir todos los sitios.

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-OneDriveLocationException

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

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-OneDriveSharedBy

El parámetro OneDriveSharedBy especifica los usuarios que se incluirán en la directiva (los sitios de las cuentas de usuario de OneDrive para la Empresa se incluyen en la directiva). Los usuarios se identifican por UPN (laura@contoso.onmicrosoft.com).

Para usar este parámetro, OneDrive para la Empresa sitios deben incluirse en la directiva (el valor del parámetro OneDriveLocation es All, que es el valor predeterminado).

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

No se puede usar este parámetro con el parámetro ExceptIfOneDriveSharedBy.

Tipo:	RecipientIdParameter[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-OneDriveSharedByMemberOf

{{ Fill OneDriveSharedByMemberOf Description }}

Tipo:	RecipientIdParameter[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	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.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-PolicyRBACScopes

El parámetro PolicyRBACScopes especifica las unidades administrativas que se van a asignar a la directiva. Un valor válido es el Microsoft Entra ObjectID (valor GUID) de la unidad administrativa. Puede especificar distintos valores separados por comas.

Las unidades administrativas solo están disponibles en Microsoft Entra ID P1 o P2. Puede crear y administrar unidades administrativas en PowerShell de Microsoft Graph.

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-PolicyTemplateInfo

Este parámetro está reservado para uso interno de Microsoft.

Tipo:	PswsHashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-Priority

El parámetro Priority especifica la prioridad de la directiva. La directiva de prioridad más alta tomará medidas sobre las directivas de prioridad inferior si dos directivas son aplicables para un archivo.

Tipo:	System.Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-SharePointAdaptiveScopes

{{ Fill SharePointAdaptiveScopes Description }}

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-SharePointAdaptiveScopesException

{{ Fill SharePointAdaptiveScopesException Description }}

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-SharePointLocation

El parámetro SharePointLocation especifica los sitios de SharePoint Online que se incluirán en la directiva. Identifique el sitio por su valor de dirección URL o use el valor All para incluir todos los sitios.

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN". Los sitios de SharePoint Online no se pueden agregar a una directiva hasta que se hayan indexado.

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-SharePointLocationException

Este parámetro especifica los sitios de SharePoint Online que se van a excluir cuando se usa el valor All para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Tipo:	MultiValuedProperty
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-UnifiedAuditLogEnabled

{{ Fill UnifiedAuditLogEnabled Description }}

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance

-WhatIf

El modificador WhatIf no funciona en Security & Compliance PowerShell.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Security & Compliance