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..
Utilize o cmdlet New-LabelPolicy para criar políticas de etiquetas de confidencialidade na sua organização.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
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 etiquetas de confidencialidade denominada Investigação e Desenvolvimento que contém etiquetas de confidencialidade denominadas Gestão de R e D e R e D.
Parâmetros
-AdvancedSettings
Aplicável: Conformidade do & de Segurança
O parâmetro AdvancedSettings permite funcionalidades e capacidades específicas do cliente para a política de etiquetas de confidencialidade.
Especifique este parâmetro com a identidade (nome ou GUID) da política, com pares chave/valor numa tabela hash. Para remover uma definição avançada, utilize a mesma sintaxe do parâmetro AdvancedSettings, mas especifique um valor de cadeia nulo.
Algumas das definições que configurar com este parâmetro são suportadas apenas pelo cliente Proteção de Informações do Microsoft Purview e não pelas aplicações e serviços do Office que suportam etiquetagem incorporada. Para obter uma lista destas, veja Definições avançadas para Proteção de Informações do Microsoft Purview cliente.
Definições suportadas para etiquetagem incorporada:
AttachmentAction: os e-mails sem etiqueta herdam a etiqueta de prioridade mais alta dos anexos de ficheiros. Defina o valor como Automático (para aplicar automaticamente a etiqueta) ou Recomendado (como pedido recomendado ao utilizador. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}. Para obter mais informações sobre esta opção de configuração, consulte Configurar a herança de etiquetas a partir de anexos de e-mail.EnableAudit: impeça que as aplicações do Office enviem dados de etiquetas de confidencialidade para soluções de auditoria do Microsoft 365. Aplicações suportadas: 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+); O Outlook no Windows (versão 2201+), Outlook na Web e a implementação para macOS, iOS e Android. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}.EnableRevokeGuiSupport: remova o botão Controlar & Revogar do menu de confidencialidade nos clientes do Office. Aplicações suportadas: Word, Excel e PowerPoint no Windows (versão 2406+). Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{EnableRevokeGuiSupport="False"}. Para obter mais informações sobre esta opção de configuração, veja Controlar e revogar o acesso ao documento.DisableMandatoryInOutlook: as aplicações do Outlook que suportam esta definição isentam as mensagens do Outlook da etiquetagem obrigatória. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}. Para obter mais informações sobre esta opção de configuração, consulte Opções específicas do Outlook para etiquetas predefinidas e etiquetagem obrigatória.DisableShowSensitiveContent: para aplicações do Office que realçam o conteúdo confidencial que fez com que uma etiqueta fosse recomendada, desative estes destaques e indicações correspondentes sobre o conteúdo confidencial. Para obter mais informações, consulte As etiquetas de confidencialidade são aplicadas ou recomendadas automaticamente para os seus ficheiros e e-mails no Office. Aplicações suportadas: Word para Windows (versão 2311+). Exemplo:
Set-LabelPolicy -Identity Global -AdvancedSettings @{DisableShowSensitiveContent="True"}OutlookDefaultLabel: as aplicações do Outlook que suportam esta definição aplicam uma etiqueta predefinida ou nenhuma etiqueta. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}. Para obter mais informações sobre esta opção de configuração, consulte Opções específicas do Outlook para etiquetas predefinidas e etiquetagem obrigatória.TeamworkMandatory: as aplicações Outlook e Teams que suportam esta definição podem ativar ou desativar a etiquetagem obrigatória para reuniões. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}. Para obter mais informações sobre a etiquetagem de reuniões, consulte Utilizar etiquetas de confidencialidade para proteger itens de calendário, reuniões do Teams e chat.teamworkdefaultlabelid: as aplicações outlook e Teams que suportam esta definição aplicam uma etiqueta predefinida ou nenhuma etiqueta para reuniões. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}. Para obter mais informações sobre a etiquetagem de reuniões, consulte Utilizar etiquetas de confidencialidade para proteger itens de calendário, reuniões do Teams e chat.HideBarByDefault: para aplicações do Office que suportam a barra de confidencialidade, não apresente o nome da etiqueta de confidencialidade no título da barra de janela para que haja mais espaço para apresentar nomes de ficheiro longos. Apenas o ícone de etiqueta e a cor (se configurado) são apresentados. Os utilizadores não podem reverter esta definição na aplicação. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}
Além disso, para o Power BI:
powerbimandatory: etiquetagem obrigatória para o Power BI. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}. Para obter mais informações sobre esta opção de configuração, veja Política de etiquetas obrigatória para o Power BI.powerbidefaultlabelid: etiqueta predefinida para conteúdo do Power BI. Exemplo:
New-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}. Para obter mais informações sobre esta opção de configuração, veja Política de etiquetas predefinida 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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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, 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 confirmar 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: Conformidade do & de Segurança
{{ Fill ExchangeAdaptiveScopes 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 |
-ExchangeAdaptiveScopesException
Aplicável: Conformidade do & de Segurança
{{ Fill 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: Conformidade do & de Segurança
O parâmetro ExchangeLocation especifica as caixas de correio a incluir na política. Um valor válido é uma caixa de correio.
Para especificar a caixa de correio, pode utilizar qualquer valor que a identifique de forma exclusiva. 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: Conformidade do & de Segurança
O parâmetro ExchangeLocationException especifica as caixas de correio a excluir quando utiliza o valor Tudo para o parâmetro ExchangeLocation. Um valor válido é uma caixa de correio.
Para especificar a caixa de correio, pode utilizar qualquer valor que a identifique de forma exclusiva. 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: Conformidade do & de Segurança
O comutador 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: Conformidade do & de Segurança
O parâmetro Etiquetas especifica as etiquetas de confidencialidade que estão associadas à 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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
O parâmetro ModernGroupLocation especifica o Grupos do Microsoft 365 a incluir na política. Para identificar o Grupo do Microsoft 365, tem de utilizar o endereço SMTP principal.
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
O parâmetro PolicyRBACScopes especifica as unidades administrativas a atribuir à 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 só estão disponíveis no Microsoft Entra ID P1 ou P2. Pode criar e gerir 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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.