Set-ArcConfig

Modul:

Exchange PowerShell

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Set-ArcConfig, um die Liste der vertrauenswürdigen ARC-Versiegelungen (Authenticated Received Chain) zu ändern, die im cloudbasierten organization konfiguriert sind.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Default (Standardwert)

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

Beschreibung

Dienste, die den Nachrichteninhalt während der Übertragung vor der Übermittlung ändern, können DKIM-E-Mail-Signaturen ungültig machen und sich auf die Authentifizierung der Nachricht auswirken. Diese Dienste können ARC verwenden, um Details zur ursprünglichen Authentifizierung bereitzustellen, bevor die Änderungen vorgenommen wurden. Ihr organization kann diese Details dann als vertrauenswürdig eingestuft werden, um die Authentifizierung der Nachricht zu unterstützen.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Set-ArcConfig -Identity Default -ArcTrustedSealers fabrikam.com

In diesem Beispiel wird "fabrikam.com" als einziger vertrauenswürdiger ARC-Versiegeler im organization konfiguriert.

Beispiel 2

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

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

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsAdd

In diesem Beispiel werden die vertrauenswürdigen ARC-Versiegelungen "cohovineyard.com" und "tailspintoys.com" hinzugefügt, ohne dass sich dies auf die anderen vertrauenswürdigen ARC-Versiegelungseinträge auswirkt.

Beispiel 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 diesem Beispiel wird die Liste der vertrauenswürdigen ARC-Siegeler geändert, indem ein vorhandener ARC-Versiegeler entfernt wird, ohne dass sich dies auf andere bereits angegebene ARC-Abdichtungen auswirkt.

Die ersten vier Befehle geben die vorhandene Liste der ARC-Versiegelungen zurück. Der erste ARC-Versiegeler in der Liste hat die Indexnummer 0, der zweite die Indexnummer 1 usw. Verwenden Sie die Indexnummer, um die ARC-Versiegelung anzugeben, die Sie entfernen möchten.

Mit den letzten beiden Befehlen wird der siebte ARC-Sealer entfernt, der in der Liste angezeigt wird.

Beispiel 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 diesem Beispiel wird der angegebene ARC-Sealer aus der Liste entfernt ($arcSealer).

Wenn nach dem Entfernen dieses Eintrags aus der Liste keine anderen ARC-Versiegelungszeichen vorhanden sind, vermeidet die Verwendung des Werts " " für den ArcTrustedSealers-Parameter einen Bindungsargumentfehler, wenn der $DomainsToRemove Wert leer ist.

Parameter

-ArcTrustedSealers

Anwendbar: Exchange Online, Exchange Online Protection

Der Parameter ArcTrustedSealers gibt den Domänennamen der ARC-Versiegelungen an, die Sie hinzufügen möchten.

Der Domänenname muss mit der Domäne übereinstimmen, die im Tag in den dHeadern ARC-Seal und ARC-Message-Signature in betroffenen E-Mail-Nachrichten angezeigt wird (z. B. fabrikam.com). Sie können Outlook verwenden, um diese Header anzuzeigen.

Verwenden Sie die Syntax Domain1,Domain2,...DomainN, um die vorhandene Liste der ARC-Versiegelungen durch die von Ihnen angegebenen Werte zu ersetzen. Um vorhandene Werte beizubehalten, müssen Sie die Einträge, die Sie beibehalten möchten, zusammen mit den neuen Werten einschließen, die Sie hinzufügen möchten.

Informationen zum Hinzufügen oder Entfernen von Werten ohne Auswirkungen auf die anderen Einträge finden Sie im Abschnitt Beispiele in diesem Artikel.

Um die Liste zu leeren, verwenden Sie den Wert " " (ein Leerzeichen in doppelten Anführungszeichen).

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Confirm

Anwendbar: Exchange Online, Exchange Online Protection

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

• Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
• Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	vgl

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Identity

Anwendbar: Exchange Online, Exchange Online Protection

Der Parameter Identity gibt die Liste der vertrauenswürdigen ARC-Versiegelungen an, die Sie ändern möchten. Verwenden Sie einen der folgenden Werte:

• Standard für Ihre eigene organization.
• <TenantID>\Default für delegierte Organisationen. Der <Wert TenantID> ist eine GUID, die in vielen URLs des Verwaltungsportals in Microsoft 365 (der tid=-Wert) sichtbar ist. Beispiel: a32d39e2-3702-4ff5-9628-31358774c091.

Parametereigenschaften

Typ:	HostedConnectionFilterPolicyIdParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	1
Obligatorisch.:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-WhatIf

Anwendbar: Exchange Online, Exchange Online Protection

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Wi

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.