New-AutoSensitivityLabelPolicy

Módulo:

ExchangePowerShell

Se aplica a:

Security & Compliance

Este cmdlet solo está disponible en PowerShell de cumplimiento de seguridad & . 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 asocielas con 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.

Syntax

New-AutoSensitivityLabelPolicy
   [-Name] <String>
   -ApplySensitivityLabel <String>
   [-Comment <String>]
   [-Confirm]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OneDriveLocation <MultiValuedProperty>]
   [-OneDriveLocationException <MultiValuedProperty>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-SharePointLocation <MultiValuedProperty>]
   [-SharePointLocationException <MultiValuedProperty>]
   [-UnifiedAuditLogEnabled <Boolean>]
   [-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

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.

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-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.

Type:	MultiValuedProperty
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. Los usuarios se identifican 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>".

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

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>".

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

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>".

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.

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>".

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.

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.

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

-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.

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

-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 (").

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

-OneDriveLocation

El parámetro OneDriveLocation especifica los sitios OneDrive para la Empresa 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".

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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".

Type:	MultiValuedProperty
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 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.

Type:	System.Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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".

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

-UnifiedAuditLogEnabled

{{ Fill UnifiedAuditLogEnabled Description }}

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