New-LabelPolicy
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
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.
Sintaxe
Default (Default)
New-LabelPolicy
-Name <String>
-Labels <MultiValuedProperty>
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-ExchangeAdaptiveScopes <MultiValuedProperty>]
[-ExchangeAdaptiveScopesException <MultiValuedProperty>]
[-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 no PowerShell de Segurança e Conformidade, 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 R e D e Gerenciamento de R e D.
Parâmetros
-AdvancedSettings
Aplicável: Segurança & Conformidade
O parâmetro AdvancedSettings habilita recursos e funcionalidades 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ê define com esse parâmetro têm suporte apenas no cliente de Proteção de Informações do Microsoft Purview e não por aplicativos e serviços do Office que dão suporte à rotulagem interna. Para obter uma lista deles, consulte Configurações avançadas para o cliente de Proteção de Informações do Microsoft Purview.
Configurações com suporte para rotulagem interna:
AttachmentAction: emails não rotulados herdam o rótulo de prioridade mais alta dos anexos de arquivo. Defina o valor como Automático (para aplicar automaticamente o rótulo) ou Recomendado (como um aviso recomendado para o usuário. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}. Para obter mais informações sobre essa opção de configuração, consulte Configurar herança de rótulo de anexos de email.EnableAudit: impedir que os aplicativos do Office enviem dados de rótulo de confidencialidade para soluções de auditoria do Microsoft 365. Aplicativos suportados: 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 implantação para macOS, iOS e Android. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}.EnableRevokeGuiSupport: Remova o botão Rastrear & Revogar do menu de confidencialidade em clientes do Office. Aplicativos compatíveis: Word, Excel e PowerPoint no Windows (versão 2406+). Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{EnableRevokeGuiSupport="False"}. Para obter mais informações sobre essa opção de configuração, consulte Rastrear e revogar o acesso a documentos.DisableMandatoryInOutlook: os aplicativos do Outlook que dão suporte a essa configuração isentam as mensagens do Outlook da rotulagem obrigatória. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}. Para obter mais informações sobre essa opção de configuração, consulte Opções específicas do Outlook para rótulo padrão e rótulo obrigatório.DisableShowSensitiveContent: para aplicativos do Office que destacam o conteúdo confidencial que causou a recomendação de um rótulo, desative esses realces e as indicações correspondentes sobre o conteúdo confidencial. Para obter mais informações, consulte Os rótulos de confidencialidade são aplicados automaticamente ou recomendados para seus arquivos e emails no Office. Aplicativos compatíveis: Word para Windows (versão 2311+). Exemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{DisableShowSensitiveContent="True"}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 opção de configuração, consulte Opções específicas do Outlook para rótulo padrão e rótulo obrigatório.Trabalho em equipeObrigatório: os aplicativos Outlook e 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 como rotular reuniões, consulte Usar rótulos de confidencialidade para proteger itens de calendário, reuniões do Teams e chat.teamworkDefaultLabelID: os aplicativos Outlook e 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 como rotular reuniões, 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 do rótulo e a cor (se configurado) sã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 opção de configuração, confira 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 opção de configuração, consulte Política de rótulo padrão para o Power BI.
Propriedades do parâmetro
| Tipo: | PswsHashtable |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Comment
Aplicável: Segurança & Conformidade
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”.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Segurança & Conformidade
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExchangeAdaptiveScopes
Aplicável: Segurança & Conformidade
{{ Preencher ExchangeAdaptiveScopes Descrição }}
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExchangeAdaptiveScopesException
Aplicável: Segurança & Conformidade
{{ Preencher ExchangeAdaptiveScopesException Description }}
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExchangeLocation
Aplicável: Segurança & Conformidade
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".
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExchangeLocationException
Aplicável: Segurança & Conformidade
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".
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Aplicável: Segurança & Conformidade
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Labels
Aplicável: Segurança & Conformidade
O parâmetro Labels 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".
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MigrationId
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ModernGroupLocation
Aplicável: Segurança & Conformidade
O parâmetro ModernGroupLocation especifica os Grupos do Microsoft 365 a serem incluídos 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".
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ModernGroupLocationException
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Default
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Segurança & Conformidade
O parâmetro Name especifica o nome exclusivo para a política. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OneDriveLocation
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OneDriveLocationException
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PolicyRBACScopes
Aplicável: Segurança & Conformidade
O parâmetro PolicyRBACScopes especifica as unidades administrativas a serem atribuídas à política. Um valor válido é o Microsoft Entra ObjectID (valor GUID) da unidade administrativa. Vários valores, separados por vírgulas, podem ser especificados.
As unidades administrativas estão disponíveis somente no Microsoft Entra ID P1 ou P2. Você cria e gerencia unidades administrativas no Microsoft Graph PowerShell.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PublicFolderLocation
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Setting
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | PswsHashtable |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Settings
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | PswsHashtable |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SharePointLocation
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SharePointLocationException
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SkypeLocation
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SkypeLocationException
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Segurança & Conformidade
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.