Set-TeamsProtectionPolicyRule

Sintaxe

Default (Padrão)

Set-TeamsProtectionPolicyRule
    [-Identity] <RuleIdParameter>
    [-Comments <String>]
    [-Confirm]
    [-ExceptIfRecipientDomainIs <Word[]>]
    [-ExceptIfSentTo <RecipientIdParameter[]>]
    [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
    [-WhatIf]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1

Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs research.contoso.com

Parâmetros

-Comments

Aplicável: Exchange Online

O parâmetro Comments especifica comentários informativos para a regra, como a finalidade de uso da regra ou as respectivas mudanças ao longo do tempo. O tamanho do comentário não pode exceder 1024 caracteres.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Aplicável: Exchange Online

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

Conjuntos de parâmetros

-ExceptIfRecipientDomainIs

Aplicável: Exchange Online

O parâmetro ExceptIfRecipientDomainIs especifica uma exceção ao ZAP para a proteção do Teams que procura destinatários de mensagens do Teams com endereços de e-mail nos domínios especificados.

Para substituir todos os domínios existentes pelos valores que especificar, utilize a seguinte sintaxe: Domain1,Domain2,...DomainN.

Para adicionar domínios sem afetar outros valores existentes, utilize a seguinte sintaxe:

$DomainsAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfRecipientDomainIs

$DomainsAdd += "Domain1","Domain2",..."DomainN"

Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs $DomainsAdd

Para remover domínios sem afetar outros valores existentes, utilize a seguinte sintaxe:

• Execute os seguintes comandos para ver a lista de valores existente por ordem:

  $x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"

  $d = [System.Collections.ArrayList]($x.ExceptIfRecipientDomainIs)

  $d

  O primeiro valor na lista tem o número de índice 0, o segundo tem o número de índice 1 e assim sucessivamente.

• Utilize o número do índice para especificar o valor a remover. Por exemplo, para remover o sétimo valor na lista, execute os seguintes comandos:

  $d.RemoveAt(6)

  Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs $d

Para esvaziar a lista, utilize o valor $null para este parâmetro.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExceptIfSentTo

Aplicável: Exchange Online

O parâmetro ExceptIfSentTo especifica uma exceção à proteção ZAP para Teams que procura destinatários de mensagens do Teams. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Para substituir todos os destinatários existentes pelos valores que especificar, utilize a seguinte sintaxe: "User1","User2",..."UserN".

Para adicionar destinatários sem afetar outros valores existentes, utilize a seguinte sintaxe:

$UsersAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfSentTo

$UsersAdd += "User1","User2",..."UserN"

Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $UsersAdd

Para remover destinatários sem afetar outros valores existentes, utilize a seguinte sintaxe:

• Execute os seguintes comandos para ver a lista de valores existente por ordem:

  $x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"

  $u = [System.Collections.ArrayList]($x.ExceptIfSentTo)

  $u

  O primeiro valor na lista tem o número de índice 0, o segundo tem o número de índice 1 e assim sucessivamente.

• Utilize o número do índice para especificar o valor a remover. Por exemplo, para remover o sétimo valor na lista, execute os seguintes comandos:

  $u.RemoveAt(6)

  Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $u

Para esvaziar a lista, utilize o valor $null para este parâmetro.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExceptIfSentToMemberOf

Aplicável: Exchange Online

O parâmetro ExceptIfSentToMemberOf especifica uma exceção à proteção ZAP para Teams que procura mensagens do Teams enviadas para membros de grupos de distribuição ou grupos de segurança com capacidade de correio. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Para adicionar grupos sem afetar outros valores existentes, utilize a seguinte sintaxe:

$GroupsAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfSentToMemberOf

$GroupsAdd += "Group1","Group2",..."GroupN"

Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentToMemberOf $GroupsAdd

Para remover grupos sem afetar outros valores existentes, utilize a seguinte sintaxe:

• Execute os seguintes comandos para ver a lista de valores existente por ordem:

  $x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"

  $g = [System.Collections.ArrayList]($x.ExceptIfSentToMemberOf)

  $g

  O primeiro valor na lista tem o número de índice 0, o segundo tem o número de índice 1 e assim sucessivamente.

• Utilize o número do índice para especificar o valor a remover. Por exemplo, para remover o sétimo valor na lista, execute os seguintes comandos:

  $g.RemoveAt(6)

  Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $g

Se remover o grupo depois de criar a regra, não será efetuada nenhuma exceção para o ZAP para o Teams para mensagens enviadas aos membros do grupo.

Para esvaziar a lista, utilize o valor $null para este parâmetro.

Propriedades do parâmetro

Conjuntos de parâmetros

-Identity

Aplicável: Exchange Online

O parâmetro Identidade especifica a regra de política de proteção do Teams que pretende modificar. Existe apenas uma regra de política de proteção do Teams numa organização denominada Regra de Política de Proteção do Teams.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Aplicável: Exchange Online

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters