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 |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de