New-LabelPolicy
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-LabelPolicy para crear directivas de etiqueta de confidencialidad 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
New-LabelPolicy
-Name <String>
-Labels <MultiValuedProperty>
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-MigrationId <String>]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-PublicFolderLocation <MultiValuedProperty>]
[-Setting <PswsHashtable>]
[-Settings <PswsHashtable>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-SkypeLocation <MultiValuedProperty>]
[-SkypeLocationException <MultiValuedProperty>]
[-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-LabelPolicy -Name "Research and Development" -Labels "R and D","R and D Management"
En este ejemplo se crea la directiva de etiquetas de confidencialidad denominada Research and Development que contiene etiquetas de confidencialidad denominada R y D y R and D Management.
Parámetros
-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.
Algunas de las opciones que configure con este parámetro solo son compatibles con Azure Information Protection cliente de etiquetado unificado y no con las 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:
New-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:
New-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:
New-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:
New-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:
New-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:
New-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:
New-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}
Además, para Power BI:
powerbimandatory: etiquetado obligatorio para Power BI. Ejemplo:
New-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:
New-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 |
-ExchangeLocation
El parámetro ExchangeLocation especifica los buzones que se van a incluir en la directiva. 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 |
-ExchangeLocationException
El parámetro ExchangeLocationException especifica los buzones que se van a excluir 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 |
-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 |
-Labels
El parámetro Labels especifica las etiquetas de confidencialidad asociadas 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: | True |
Accept pipeline input: | False |
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 |
-ModernGroupLocation
El parámetro ModernGroupLocation especifica el Grupos de Microsoft 365 que se va a incluir en la directiva. 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 |
-ModernGroupLocationException
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 |
-Name
El parámetro Name especifica el nombre único de la directiva. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OneDriveLocation
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 |
-OneDriveLocationException
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 |
-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 |
-PublicFolderLocation
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 |
-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 |
-SharePointLocation
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 |
-SharePointLocationException
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 |
-SkypeLocation
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 |
-SkypeLocationException
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 |
-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 |