New-LabelPolicy

Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, confira PowerShell de Conformidade de Segurança&.

Use o cmdlet New-LabelPolicy para criar políticas de rótulo de confidencialidade em sua organização.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

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 esse cmdlet no PowerShell de Conformidade de Segurança & , você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.

Exemplos

Exemplo 1

New-LabelPolicy -Name "Research and Development" -Labels "R and D","R and D Management"

Este exemplo cria a política de rótulo de confidencialidade chamada Pesquisa e Desenvolvimento que contém rótulos de confidencialidade chamados Gerenciamento de R e D e R e D.

Parâmetros

-AdvancedSettings

O parâmetro AdvancedSettings permite recursos e recursos específicos do cliente para a política de rótulo de confidencialidade.

Especifique esse parâmetro com a identidade (nome ou GUID) da política, com pares de chave/valor em uma tabela de hash. Para remover uma configuração avançada, use a mesma sintaxe de parâmetro AdvancedSettings, mas especifique um valor de cadeia de caracteres nulo.

Algumas das configurações que você configura com esse parâmetro têm suporte apenas pelo cliente de rotulagem unificada do Azure Proteção de Informações e não por aplicativos do Office que dão suporte à rotulagem interna. Para obter instruções, consulte Configurações personalizadas para o cliente de rotulagem unificada do Azure Proteção de Informações.

Configurações com suporte para rotulagem interna:

  • AttachmentAction: os emails não rotulados herdam o rótulo de prioridade mais alto dos anexos de arquivo. Defina o valor como Automático (para aplicar automaticamente o rótulo) ou Recomendado (como um prompt recomendado para o usuário. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}. Para obter mais informações sobre essa escolha de configuração, consulte Configurar herança de rótulo de anexos de email.

  • EnableAudit: impedir que aplicativos do Office enviem dados de rótulo de confidencialidade para soluções de auditoria do Microsoft 365. Aplicativos com suporte: Word, Excel e PowerPoint no Windows (versão 2201+), macOS (versão 16.57+), iOS (versão 2.57+) e Android (versão 16.0.14827+); Outlook no Windows (versão 2201+), Outlook na Web e lançamento para macOS, iOS e Android. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}.

  • DisableMandatoryInOutlook: aplicativos do Outlook que dão suporte a essa configuração isentam mensagens do Outlook de rotulagem obrigatória. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}. Para obter mais informações sobre essa escolha de configuração, consulte opções específicas do Outlook para rótulo padrão e rotulagem obrigatória.

  • OutlookDefaultLabel: os aplicativos do Outlook que dão suporte a essa configuração aplicam um rótulo padrão ou nenhum rótulo. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}. Para obter mais informações sobre essa escolha de configuração, consulte opções específicas do Outlook para rótulo padrão e rotulagem obrigatória.

  • TeamworkMandatory: aplicativos do Outlook e do Teams que dão suporte a essa configuração podem habilitar ou desabilitar a rotulagem obrigatória para reuniões. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}. Para obter mais informações sobre reuniões de rotulagem, consulte Usar rótulos de confidencialidade para proteger itens de calendário, reuniões do Teams e chat.

  • teamworkdefaultlabelid: aplicativos do Outlook e do Teams que dão suporte a essa configuração aplicam um rótulo padrão ou nenhum rótulo para reuniões. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}. Para obter mais informações sobre reuniões de rotulagem, consulte Usar rótulos de confidencialidade para proteger itens de calendário, reuniões do Teams e chat.

  • HideBarByDefault: para aplicativos do Office que dão suporte à barra de confidencialidade, não exiba o nome do rótulo de confidencialidade no título da barra de janela para que haja mais espaço para exibir nomes de arquivo longos. Apenas o ícone de rótulo e a cor (se configurado) serão exibidos. Os usuários não podem reverter essa configuração no aplicativo. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}

Além disso, para o Power BI:

  • powerbimandatory: rotulagem obrigatória para o Power BI. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}. Para obter mais informações sobre essa escolha de configuração, consulte Política de rótulo obrigatório para o Power BI.

  • powerbidefaultlabelid: rótulo padrão para conteúdo do Power BI. Exemplo: New-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}. Para obter mais informações sobre essa escolha de configuração, consulte Política de rótulo padrão 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

O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.

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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o 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

O parâmetro ExchangeLocation especifica as caixas de correio a serem incluídas na política. Um valor válido é uma caixa de correio.

Para especificar a caixa de correio, você pode usar qualquer valor que a identifique exclusivamente. Por exemplo:

  • Nome
  • Nome
  • Nome diferenciado (DN)
  • GUID

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "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

O parâmetro ExchangeLocationException especifica as caixas de correio a serem excluídas quando você usa o valor All para o parâmetro ExchangeLocation. Um valor válido é uma caixa de correio.

Para especificar a caixa de correio, você pode usar qualquer valor que a identifique exclusivamente. Por exemplo:

  • Nome
  • Nome
  • Nome diferenciado (DN)
  • GUID

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "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

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.

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

-Labels

O parâmetro Rótulos especifica os rótulos de confidencialidade associados à política. É possível usar qualquer valor que identifique o rótulo com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "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

Esse parâmetro está reservado para uso interno da Microsoft.

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

-ModernGroupLocation

O parâmetro ModernGroupLocation especifica o Grupos do Microsoft 365 a ser incluído na política. Para identificar o Grupo do Microsoft 365, você deve usar o endereço SMTP primário.

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "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

Esse parâmetro está reservado para uso interno da Microsoft.

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

-Name

O parâmetro Name especifica o nome exclusivo da política. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

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

-OneDriveLocation

Esse parâmetro está reservado para uso interno da Microsoft.

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

-OneDriveLocationException

Esse parâmetro está reservado para uso interno da 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

Esse parâmetro está reservado para uso interno da Microsoft.

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

-Setting

Esse parâmetro está reservado para uso interno da Microsoft.

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

-Settings

Esse parâmetro está reservado para uso interno da Microsoft.

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

-SharePointLocation

Esse parâmetro está reservado para uso interno da Microsoft.

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

-SharePointLocationException

Esse parâmetro está reservado para uso interno da Microsoft.

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

-SkypeLocation

Esse parâmetro está reservado para uso interno da Microsoft.

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

-SkypeLocationException

Esse parâmetro está reservado para uso interno da Microsoft.

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

-WhatIf

A opção WhatIf não funciona no PowerShell de Conformidade de Segurança & .

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