Set-ArcConfig

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-ArcConfig per modificare l'elenco dei sealer ARC (Authenticated Received Chain) attendibili configurati nell'organizzazione basata sul cloud.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

I servizi che modificano il contenuto del messaggio in transito prima del recapito possono invalidare le firme di posta elettronica DKIM e influire sull'autenticazione del messaggio. Questi servizi possono usare ARC per fornire i dettagli dell'autenticazione originale prima che si verificasse la modifica. L'organizzazione può quindi considerare attendibili questi dettagli per consentire l'autenticazione del messaggio.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-ArcConfig -Identity Default -ArcTrustedSealers fabrikam.com

Questo esempio configura "fabrikam.com" come unico sealer ARC attendibile nell'organizzazione.

Esempio 2

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

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

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsAdd

In questo esempio vengono aggiunti i sealer ARC attendibili "cohovineyard.com" e "tailspintoys.com" senza influire sulle altre voci attendibili del sealer ARC.

Esempio 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

In questo esempio viene modificato l'elenco dei sealer ARC attendibili rimuovendo un sealer ARC esistente senza influire su altri sealer ARC già specificati.

I primi quattro comandi restituiscono l'elenco esistente di sealer ARC. Il primo sealer ARC nell'elenco ha il numero di indice 0, il secondo ha il numero di indice 1 e così via. Utilizzare il numero di indice per specificare il sealer ARC da rimuovere.

Gli ultimi due comandi consentono di rimuovere il settimo sealer ARC visualizzato nell'elenco.

Esempio 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
   }

In questo esempio viene rimosso il sealer ARC specificato dall'elenco ($arcSealer).

Se non esistono altri sealer ARC dopo aver rimosso questa voce dall'elenco, l'uso del valore " " per il parametro ArcTrustedSealers evita un errore di argomento di associazione se il $DomainsToRemove valore è vuoto.

Parametri

-ArcTrustedSealers

Il parametro ArcTrustedSealers specifica il nome di dominio dei sealer ARC da aggiungere.

Il nome di dominio deve corrispondere al dominio visualizzato nel tag nelle d intestazioni ARC-Seal e ARC-Message-Signature nei messaggi di posta elettronica interessati (ad esempio, fabrikam.com). È possibile usare Outlook per visualizzare queste intestazioni.

Per sostituire l'elenco esistente di sealer ARC con i valori specificati, usare la sintassi Domain1,Domain2,...DomainN. Per mantenere i valori esistenti, assicurarsi di includere le voci che si desidera mantenere insieme ai nuovi valori che si desidera aggiungere.

Per aggiungere o rimuovere valori senza influire sulle altre voci, vedere la sezione Esempi di questo articolo.

Per svuotare l'elenco, usare il valore " " (uno spazio racchiuso tra virgolette doppie).

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Online, Exchange Online Protection

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Online, Exchange Online Protection

-Identity

Il parametro Identity consente di specificare l'elenco di sealer ARC attendibili che si desidera modificare. Utilizzare uno dei seguenti valori:

Impostazione predefinita per la propria organizzazione.
<TenantID>\Default per le organizzazioni delegate. Il <valore TenantID> è un GUID visibile in molti URL del portale di amministrazione in Microsoft 365 (il valore tid=). Ad esempio, a32d39e2-3702-4ff5-9628-31358774c091.

Tipo:	HostedConnectionFilterPolicyIdParameter
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False
Si applica a:	Exchange Online, Exchange Online Protection

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Online, Exchange Online Protection

Condividi tramite