Partilhar via


Set-LabelPolicy

Esse cmdlet é funcional apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, confira PowerShell de Conformidade de Segurança&.

Use o cmdlet Set-Label para modificar 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

Set-LabelPolicy
   [-Identity] <PolicyIdParameter>
   -RetryDistribution
   [-AddLabels <MultiValuedProperty>]
   [-AdvancedSettings <PswsHashtable>]
   [-Confirm]
   [-MigrationId <String>]
   [-NextLabelPolicy <PolicyIdParameter>]
   [-PreviousLabelPolicy <PolicyIdParameter>]
   [-RemoveLabels <MultiValuedProperty>]
   [<CommonParameters>]
Set-LabelPolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddExchangeLocationException <MultiValuedProperty>]
   [-AddLabels <MultiValuedProperty>]
   [-AddModernGroupLocation <MultiValuedProperty>]
   [-AddModernGroupLocationException <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddPublicFolderLocation <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-AddSkypeLocation <MultiValuedProperty>]
   [-AddSkypeLocationException <MultiValuedProperty>]
   [-AdvancedSettings <PswsHashtable>]
   [-Comment <String>]
   [-Confirm]
   [-MigrationId <String>]
   [-NextLabelPolicy <PolicyIdParameter>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveExchangeLocationException <MultiValuedProperty>]
   [-RemoveLabels <MultiValuedProperty>]
   [-RemoveModernGroupLocation <MultiValuedProperty>]
   [-RemoveModernGroupLocationException <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemovePublicFolderLocation <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-RemoveSkypeLocation <MultiValuedProperty>]
   [-RemoveSkypeLocationException <MultiValuedProperty>]
   [<CommonParameters>]
Set-LabelPolicy
   [-Identity] <PolicyIdParameter>
   [-AddLabels <MultiValuedProperty>]
   [-AdvancedSettings <PswsHashtable>]
   [-Comment <String>]
   [-Confirm]
   [-Force]
   [-MigrationId <String>]
   [-NextLabelPolicy <PolicyIdParameter>]
   [-PreviousLabelPolicy <PolicyIdParameter>]
   [-RemoveLabels <MultiValuedProperty>]
   [-Setting <PswsHashtable>]
   [-Settings <PswsHashtable>]
   [-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.

Observação: não use um comando de Foreach-Object encanado ao adicionar ou remover locais de escopo: "Value1","Value2",..."ValueN" | Foreach-Object {Set-LabelPolicy -Identity "Global Policy" -RemoveExchangeLocation $_ }.

Exemplos

Exemplo 1

Set-LabelPolicy -Identity "Global Policy" -AdvancedSettings @{EnableCustomPermissions="False"}

Este exemplo configura a configuração avançada especificada para o nome da política de rótulo de confidencialidade Política Global.

Parâmetros

-AddExchangeLocation

O parâmetro AddExchangeLocation especifica as caixas de correio a serem adicionadas à lista de caixas de correio incluídas quando você não estiver usando 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

-AddExchangeLocationException

O parâmetro AddExchangeLocationException especifica as caixas de correio a serem adicionadas à lista de caixas de correio 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

-AddLabels

O parâmetro AddLabels especifica os rótulos de confidencialidade que você deseja adicionar à 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:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddModernGroupLocation

O parâmetro AddModernGroupLocation especifica o Grupos do Microsoft 365 a ser adicionado à lista de Grupos do Microsoft 365 incluídos. 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

-AddModernGroupLocationException

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

-AddOneDriveLocation

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

-AddOneDriveLocationException

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

-AddPublicFolderLocation

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

-AddSharePointLocation

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

-AddSharePointLocationException

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

-AddSkypeLocation

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

-AddSkypeLocationException

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

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

A maioria das configurações que você configura com esse parâmetro tem 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: Set-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: Set-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: Set-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: Set-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: Set-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: Set-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: Set-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}

Além disso, para o Power BI:

  • powerbimandatory: rotulagem obrigatória para o Power BI. Exemplo: Set-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: Set-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

-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

-Identity

O parâmetro Identity especifica a política que você deseja exibir. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:PolicyIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
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

-NextLabelPolicy

O parâmetro NextLabelPolicy atualiza a ordem de política para que a política especificada por esse parâmetro seja após a política atual que você está modificando. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:PolicyIdParameter
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

-PreviousLabelPolicy

O parâmetro PreviousLabelPolicy atualiza a ordem de política para que a política especificada por esse parâmetro esteja antes da política atual que você está modificando. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:PolicyIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveExchangeLocation

O parâmetro RemoveExchangeLocation especifica as caixas de correio a serem removidas da lista de caixas de correio incluídas quando você não estiver usando o valor All para o parâmetro ExchangeLocation. Os valores válidos são:

  • O parâmetro ExchangeLocation especifica as caixas de correio que devem ser incluídas na política. Os valores válidos são:
  • Uma caixa de correio

O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.

  • 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

-RemoveExchangeLocationException

O parâmetro RemoveExchangeLocationException especifica as caixas de correio a serem removidas da lista de caixas de correio excluídas quando você estiver usando o valor All para o parâmetro ExchangeLocation. Os valores válidos são:

  • O parâmetro ExchangeLocation especifica as caixas de correio que devem ser incluídas na política. Os valores válidos são:
  • Uma caixa de correio

O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.

  • 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

-RemoveLabels

O parâmetro RemoveLabels especifica os rótulos de confidencialidade que você deseja remover da 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:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveModernGroupLocation

O parâmetro RemoveModernGroupLocation especifica o Grupos do Microsoft 365 para remover da lista de grupos incluídos. 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

-RemoveModernGroupLocationException

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

-RemoveOneDriveLocation

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

-RemoveOneDriveLocationException

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

-RemovePublicFolderLocation

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

-RemoveSharePointLocation

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

-RemoveSharePointLocationException

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

-RemoveSkypeLocation

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

-RemoveSkypeLocationException

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

-RetryDistribution

A opção RetryDistribution especifica se a política deve ser redistribuída para todos os Exchange Online locais. Não é preciso especificar um valor com essa opção.

Locais cujas distribuições iniciais tenham êxito não são incluídos na repetição. Ao usar essa opção, os erros de distribuição de política são relatados.

Observação: como o processo de repetição da distribuição é uma operação significativa, execute-a somente se necessário e para uma política por vez. Ele não se destina a ser executado sempre que você atualizar uma política. Se você executar um script para atualizar várias políticas, aguarde até que a distribuição de política seja bem-sucedida antes de executar o comando novamente para a próxima política.

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

-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