Set-AutoSensitivityLabelPolicy

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 Set-AutoSensitivityLabelPolicy para modificar políticas de rotulagem automática em sua organização.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-ApplySensitivityLabel <String>]
   [-AutoEnableAfter <Timespan>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-SpoAipIntegrationEnabled <Boolean>]
   [-StartSimulation <Boolean>]
   [-SystemOperation]
   [-WhatIf]
   [<CommonParameters>]
Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-Mode <PolicyMode>]
   [-WhatIf]
   [<CommonParameters>]
Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Confirm]
   [-Mode <PolicyMode>]
   [-RetryDistribution]
   [-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

Set-AutoSensitivityLabelPolicy -Identity "Main PII" -AddSharePointLocation "https://my.url1","https://my.url2" -AddOneDriveLocation "https://my.url3","https://my.url4"

Este exemplo adiciona as URLs especificadas aos locais do SharePoint Online e OneDrive for Business para a política de rotulagem automática chamada PII Principal sem afetar os valores de URL existentes.

Parâmetros

-AddExchangeLocation

O parâmetro AddExchangeLocation adiciona mensagens de email à política se elas ainda não estiverem incluídas. O valor válido para esse parâmetro é All.

Se a política ainda não incluir mensagens de email (na saída do cmdlet Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation estará em branco), você poderá usar esse parâmetro nos seguintes procedimentos:

  • Se você usar -AddExchangeLocation All por si só, a política se aplica ao email para todos os usuários internos.

  • Para incluir email de usuários internos ou externos específicos na política, use -AddExchangeLocation All com o parâmetro ExchangeSender no mesmo comando. Somente o email dos usuários especificados está incluído na política.

  • Para incluir email de membros específicos do grupo na política, use -AddExchangeLocation All com o parâmetro ExchangeSenderMemberOf no mesmo comando. Somente o email de membros dos grupos especificados está incluído na política.

  • Para excluir o email de usuários internos específicos da política, use -AddExchangeLocation All com o parâmetro ExchangeSenderException no mesmo comando. Somente o email dos usuários especificados é excluído da política.

  • Para excluir o email de membros de grupo específicos da política, use -AddExchangeLocation All com o parâmetro ExchangeSenderMemberOfException no mesmo comando. Somente o email de membros dos grupos especificados é excluído da política.

Você não pode especificar inclusões e exclusões na mesma política.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddOneDriveLocation

O parâmetro AddOneDriveLocation especifica os OneDrive for Business sites a serem adicionados à lista de sites incluídos quando você não estiver usando o valor All para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddOneDriveLocationException

O parâmetro AddOneDriveLocationException especifica os OneDrive for Business sites a serem adicionados à lista de sites excluídos quando você usa o valor All para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocation

O parâmetro AddSharePointLocation especifica os sites do SharePoint Online a serem adicionados à lista de sites incluídos quando você não estiver usando o valor All para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.

Os sites do SharePoint Online não podem ser adicionados à política até que tenham sido indexados.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocationException

O parâmetro AddSharePointLocationException especifica os sites do SharePoint Online a serem adicionados à lista de sites excluídos quando você usa o valor All para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplySensitivityLabel

O parâmetro ApplySensitivityLabel seleciona qual rótulo será usado para a política. Isso substituirá o rótulo anterior na política.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AutoEnableAfter

O parâmetro AutoEnableAfter permite ativar automaticamente a política após um período definido na simulação. O período de tempo é reiniciado sempre que você modifica a política ou quando uma simulação é disparada.

Para especificar um valor, insira-o como um período de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Um valor válido é entre 1 hora e 25 dias.

Você deve usar esse parâmetro com o parâmetro -StartSimulation.

Type:System.TimeSpan
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

-Enabled

O parâmetro Habilitado habilita ou desabilita a política. Os valores válidos são:

  • $true: a política está habilitada. Esse é o valor padrão.
  • $true: a política está habilitada. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSender

O parâmetro ExchangeSender especifica os usuários cujo email está incluído na política. Especifique os usuários por endereço de email. Você pode especificar endereços de email internos ou externos.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Para usar esse parâmetro, uma das seguintes instruções deve ser verdadeira:

  • A política já inclui mensagens de email (na saída do cmdlet Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é All).
  • Use -AddExchangeLocation All no mesmo comando com esse parâmetro.

Você não pode usar esse parâmetro com os parâmetros ExchangeSenderException ou ExchangeSenderMemberOfException.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderException

O parâmetro ExchangeSenderException especifica os usuários internos cujo email é excluído da política. Você identifica os usuários por endereço de email.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Para usar esse parâmetro, uma das seguintes instruções deve ser verdadeira:

  • A política já inclui mensagens de email (na saída de Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é All).
  • Use -AddExchangeLocation All no mesmo comando com esse parâmetro.

Você não pode usar esse parâmetro com os parâmetros ExchangeSender ou ExchangeSenderMemberOf.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderMemberOf

O parâmetro ExchangeSenderMemberOf especifica os grupos de distribuição ou grupos de segurança habilitados para email a serem incluídos na política (o email dos membros do grupo está incluído na política). Você identifica os grupos por endereço de email.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Para usar esse parâmetro, uma das seguintes instruções deve ser verdadeira:

  • A política já inclui mensagens de email (na saída de Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é All).
  • Use -AddExchangeLocation All no mesmo comando com esse parâmetro.

Você não pode usar esse parâmetro com os parâmetros ExchangeSenderException ou ExchangeSenderMemberOfException.

Você não pode usar esse parâmetro para especificar Grupos do Microsoft 365.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderMemberOfException

O parâmetro ExchangeSenderMemberOfException especifica os grupos de distribuição ou grupos de segurança habilitados para email a serem excluídos da política (o email dos membros do grupo é excluído da política). Você identifica os grupos por endereço de email.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Para usar esse parâmetro, uma das seguintes instruções deve ser verdadeira:

  • A política já inclui mensagens de email (na saída de Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é All).
  • Use -AddExchangeLocation All no mesmo comando com esse parâmetro.

Você não pode usar esse parâmetro com os parâmetros ExchangeSender ou ExchangeSenderMemberOf.

Você não pode usar esse parâmetro para especificar Grupos do Microsoft 365.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExternalMailRightsManagementOwner

O parâmetro ExternalMailRightsManagementOwner especifica o endereço de email de uma caixa de correio do usuário usada para criptografar mensagens de email de entrada de remetentes externos usando RMS.

Esse parâmetro funciona apenas em locais do Exchange e a política deve aplicar um rótulo que tenha uma ação de criptografia.

Para limpar um endereço de email existente, use o valor $null.

Type:SmtpAddress
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 de rotulagem automática que você deseja modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

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

-Mode

O parâmetro Mode especifica o nível de ação e notificação da política de rotulagem automática. Os valores válidos são:

  • Habilitar: a política está habilitada para ações e notificações.
  • Enable: a política está habilitada para notificações e ações. Este é o valor padrão.
  • TestWithNotifications: não há suporte.
  • TestWithoutNotifications: um modo de auditoria em que nenhuma ação é tomada e nenhuma notificações é enviada (modo de teste).
Type:PolicyMode
Accepted values:Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-OverwriteLabel

O parâmetro OverwriteLabel especifica se deve substituir um rótulo manual. Os valores válidos são:

  • $true: substitua o rótulo manual.
  • $false: não substitua o rótulo manual. Esse é o valor padrão.

Esse parâmetro funciona apenas em locais do Exchange.

Type:Boolean
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

-PolicyTemplateInfo

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

-Priority

O parâmetro Priority especifica um valor de prioridade para a política que determina a ordem de processamento de política. Um valor inteiro menor indica uma prioridade maior, o valor 0 é a prioridade mais alta e as políticas não podem ter o mesmo valor de prioridade.

Os valores válidos e o valor padrão para esse parâmetro dependem do número de políticas existentes. Por exemplo, se houver 5 políticas existentes:

  • Os valores de prioridade válidos para as 5 políticas existentes são de 0 a 4.
  • Os valores de prioridade válidos para uma nova política de 6º são de 0 a 5.
  • O valor padrão de uma nova política 6 é 5.

Se você modificar o valor prioritário de uma política, a posição da política na lista será alterada para corresponder ao valor de prioridade especificado. Em outras palavras, se você definir o valor prioritário de uma política como o mesmo valor de uma política existente, o valor prioritário da política existente e todas as outras políticas de menor prioridade depois que ela for aumentada em 1.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveExchangeLocation

O parâmetro RemoveExchangeLocation remove mensagens de email da política se elas já estiverem incluídas. O valor válido para esse parâmetro é All.

Se a política já incluir mensagens de email (na saída do cmdlet Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é All), você poderá usar -RemoveExchangeLocation All para impedir que a política se aplique às mensagens de email.

Você não poderá usar esse parâmetro se o email (o valor Exchange) for usado por qualquer uma das regras associadas.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveOneDriveLocation

O parâmetro RemoveOneDriveLocation especifica os OneDrive for Business sites a serem removidos da lista de sites incluídos quando você não estiver usando o valor All para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveOneDriveLocationException

Este parâmetro RemoveOneDriveLocationException especifica os OneDrive for Business sites a serem removidos da lista de sites excluídos quando você usa o valor All para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocation

O parâmetro RemoveSharePointLocation especifica os sites do SharePoint Online a serem removidos da lista de sites incluídos quando você não estiver usando o valor All para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocationException

O parâmetro RemoveSharePointLocationException especifica os sites do SharePoint Online a serem removidos da lista de sites excluídos quando você usa o valor All para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

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 redistribui a política para todos os locais do OneDrive for Business e do SharePoint Online. 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

-SpoAipIntegrationEnabled

{{ Preencher SpoAipIntegrationEnabled Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-StartSimulation

Use o parâmetro StartSimulation para reiniciar a simulação para obter resultados atualizados. Os valores válidos são:

  • $true: reinicie a simulação para obter resultados atualizados.
  • $false: esse é o valor padrão
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SystemOperation

{{ Preenchimento Descrição do SystemOperation }}

Type:SwitchParameter
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