Set-ArcConfig

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Online, Exchange Online Protection

Esse cmdlet só está disponível no serviço baseado em nuvem.

Utilize o cmdlet Set-ArcConfig para modificar a lista de seladores fidedignos da Cadeia De Receção Autenticada (ARC) que estão configurados na organização baseada na cloud.

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

Sintaxe

Set-ArcConfig
   [-Identity] <HostedConnectionFilterPolicyIdParameter>
   -ArcTrustedSealers <String[]>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

Os serviços que modificam o conteúdo da mensagem em trânsito antes da entrega podem invalidar as assinaturas de e-mail do DKIM e afetar a autenticação da mensagem. Estes serviços podem utilizar o ARC para fornecer detalhes sobre a autenticação original antes de as modificações ocorrerem. Em seguida, a sua organização pode confiar nestes detalhes para ajudar a autenticar a mensagem.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-ArcConfig -Identity Default -ArcTrustedSealers fabrikam.com

Este exemplo configura "fabrikam.com" como o único selador ARC fidedigno na organização.

Exemplo 2

$DomainsAdd = @(Get-ArcConfig | select -Expand ArcTrustedSealers)

$DomainsAdd += "cohovineyard.com","tailspintoys.com"

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsAdd

Este exemplo adiciona os sealers ARC fidedignos "cohovineyard.com" e "tailspintoys.com" sem afetar as outras entradas de vedação ARC fidedignas.

Exemplo 3

$x = @(Get-ArcConfig | select -Expand ArcTrustedSealers)

$y = $x.Split(",")

$DomainsRemove = [System.Collections.ArrayList]($y)

$DomainsRemove

$DomainsRemove.RemoveAt(6)

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove

Este exemplo modifica a lista de seladores ARC fidedignos ao remover um selador ARC existente sem afetar outros sealers ARC que já estão especificados.

Os primeiros quatro comandos devolvem a lista existente de sealers ARC. O primeiro selador ARC 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 selador ARC que pretende remover.

Os dois últimos comandos removem o sétimo selador ARC que é apresentado na lista.

Exemplo 4

$arcSealer = 'fabrikam.com'
$x = @(Get-ArcConfig | Select-Object -Expand ArcTrustedSealers)

$y = @($x.Split(","))
$DomainsRemove = [System.Collections.ArrayList]($y)
$DomainsRemove.Remove($arcSealer)

if ($DomainsToRemove.Count -eq 0) {        
   Set-ArcConfig -Identity Default -ArcTrustedSealers " "
   }
else {
   Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove
   }

Este exemplo remove o selador ARC especificado da lista ($arcSealer).

Se não existirem outros sealers ARC depois de remover esta entrada da lista, utilizar o valor " " para o parâmetro ArcTrustedSealers evita um erro de argumento de enlace se o $DomainsToRemove valor estiver vazio.

Parâmetros

-ArcTrustedSealers

O parâmetro ArcTrustedSealers especifica o nome de domínio dos sealers arc que pretende adicionar.

O nome de domínio tem de corresponder ao domínio apresentado na etiqueta nos d cabeçalhos ARC-Seal e ARC-Message-Signature nas mensagens de e-mail afetadas (por exemplo, fabrikam.com). Pode utilizar o Outlook para ver estes cabeçalhos.

Para substituir a lista existente de sealers ARC pelos valores que especificar, utilize a sintaxe Domain1,Domain2,...DomainN. Para preservar os valores existentes, certifique-se de que inclui as entradas que pretende manter juntamente com os novos valores que pretende adicionar.

Para adicionar ou remover valores sem afetar as outras entradas, veja a secção Exemplos neste artigo.

Para esvaziar a lista, utilize o valor " " (um espaço entre aspas duplas).

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False
Aplica-se a:	Exchange Online, Exchange Online Protection

-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, 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.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False
Aplica-se a:	Exchange Online, Exchange Online Protection

-Identity

O parâmetro Identity especifica a lista de sealers ARC fidedignos que pretende modificar. Use um dos valores a seguir:

Predefinição para a sua própria organização.
<TenantID>\Default para organizações delegadas. O <valor TenantID> é um GUID que está visível em muitos URLs do portal de administração no Microsoft 365 (o valor tid=). Por exemplo, a32d39e2-3702-4ff5-9628-31358774c091.

Tipo:	HostedConnectionFilterPolicyIdParameter
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False
Aplica-se a:	Exchange Online, Exchange Online Protection

-WhatIf

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.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False
Aplica-se a:	Exchange Online, Exchange Online Protection

Partilhar via