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 |