Rotate-DkimSigningConfig
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet Rotate-DkimSigningConfig, um die öffentlichen und privaten DKIM-Signaturrichtlinienschlüssel (DomainKeys Identified Mail) für Domänen in einem cloudbasierten organization zu rotieren. Dieses Cmdlet erstellt neue DKIM-Schlüssel und verwendet den alternativen DKIM-Selektor.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Rotate-DkimSigningConfig
[-Identity] <DkimSigningConfigIdParameter>
[-Confirm]
[-KeySize <UInt16>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
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
Rotate-DkimSigningConfig -Identity contoso.com
In diesem Beispiel wird die DKIM-Signaturrichtlinie für die domäne contoso.com rotiert.
Parameter
-Confirm
Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich dieser Schalter auf das Cmdlet auswirkt, hängt davon ab, ob das Cmdlet vor dem Fortfahren eine Bestätigung erfordert.
- 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. Für diese Cmdlets führt die Angabe des Schalters Confirm ohne einen Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Cf |
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, integriertes Sicherheits-Add-On für lokale Postfächer
Der Parameter Identity gibt die DKIM-Signaturrichtlinie an, die Sie rotieren möchten. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Beispiel:
- Name: Der Domänenname (z. B. contoso.com).
- Distinguished Name (DN)
- GUID
Parametereigenschaften
| Typ: | DkimSigningConfigIdParameter |
| 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 |
-KeySize
Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer
Der KeySize-Parameter gibt die Größe in Bits des öffentlichen Schlüssels an, der in der DKIM-Signierungsrichtlinie verwendet wird. Gültige Werte sind:
- 1024
- 2048
RSA-Schlüssel werden unterstützt. Ed25519-Schlüssel werden nicht unterstützt.
Hinweis: Durch ein Upgrade der Schlüsselgröße auf 2048 wird nur die Auswahl aktualisiert, die derzeit nicht aktiv ist. Nachdem die Schlüsselrotation stattgefunden hat, müssen Sie den Befehl erneut ausführen, um die Schlüsselgröße der anderen Auswahl zu aktualisieren.
Parametereigenschaften
| Typ: | UInt16 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer
Die WhatIf-Option zeigt an, was der Befehl tut, ohne Änderungen vorzunehmen. 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.