Enable-ExchangeCertificate

Modul:: Exchange PowerShell

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Enable-ExchangeCertificate Cmdlet, um ein vorhandenes Zertifikat auf dem Exchange-Server für Exchange-Dienste wie Internetinformationsdienste (IIS), SMTP, POP, IMAP und Unified Messaging (UM) zu aktivieren. Nachdem Sie ein Zertifikat für einen Dienst aktiviert haben, können Sie es nicht mehr deaktivieren.

Verwenden Sie Get-ExchangeCertificate, um die vorhandenen Zertifikate anzuzeigen, die für Exchange-Dienste verwendet werden.

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

Syntax

Thumbprint

Enable-ExchangeCertificate
    [-Thumbprint] <String>
    -Services <AllowedServices>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DoNotRequireSsl]
    [-Force]
    [-NetworkServiceAllowed]
    [-Server <ServerIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Identity

Enable-ExchangeCertificate
    [[-Identity] <ExchangeCertificateIdParameter>]
    -Services <AllowedServices>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DoNotRequireSsl]
    [-Force]
    [-NetworkServiceAllowed]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Das Enable-ExchangeCertificate Cmdlet aktiviert Zertifikate, indem die Metadaten aktualisiert werden, die mit dem Zertifikat gespeichert werden. Verwenden Sie dieses Cmdlet, um die Dienste anzugeben, damit ein vorhandenes Zertifikat mit zusätzlichen Exchange-Diensten funktioniert.

Nach dem Ausführen des Cmdlets Enable-ExchangeCertificate müssen Sie die Internetinformationsdienste (IIS) möglicherweise neu starten. In einigen Szenarien möchte Exchange möglicherweise weiterhin das vorherigen Zertifikat zum Verschlüsseln und Entschlüsseln von Cookies verwenden, das für die Outlook im Web-Authentifizierung (ehemals Outlook Web App) verwendet wurde. Es wird empfohlen, IIS in Umgebungen neu zu starten, die Layer 4-Lastenausgleich verwenden.

Beim Konfigurieren von Zertifikaten für TLS-Dienste (Transport Layer Security) sind viele Faktoren zu berücksichtigen. Sie müssen wissen, welche Auswirkungen diese Faktoren auf Ihre Gesamtkonfiguration haben. Weitere Informationen finden Sie unter Digitale Zertifikate und Verschlüsselung in Exchange Server.

TLS hat SSL (Secure Sockets Layer) als Protokoll zum Verschlüsseln von Daten ersetzt, die zwischen Computersystemen gesendet werden. In der Vergangenheit wurden "TLS" und "SSL" oft synonym verwendet. Jeder Verweis auf SSL in der Exchange-Dokumentation bedeutet tatsächlich TLS, es sei denn, es ist auch eine Versionsnummer enthalten (z. B. SSL 3.0). Weitere Informationen finden Sie unter Bewährte Methoden für die TLS-Konfiguration von Exchange Server.

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

Enable-ExchangeCertificate -Thumbprint 5113ae0233a72fccb75b1d0198628675333d010e -Services POP,IMAP,SMTP,IIS

In diesem Beispiel wird ein Zertifikat für POP-, IMAP-, SMTP- und IIS-Dienste aktiviert.

Parameter

-Confirm

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

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 die Angabe des Bestätigungsschalters ohne 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:	vgl

Parametersätze

(All)

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

-DomainController

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Der DomainController-Parameter wird auf Edge-Transport-Servern nicht unterstützt. Edge-Transport-Server verwenden die lokale Instanz von Active Directory Lightweight Directory Services (AD LDS), um Daten zu lesen und zu schreiben.

Parametereigenschaften

Typ:	Fqdn
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

-DoNotRequireSsl

Der Schalter DoNotRequireSsl verhindert, dass der Befehl die Einstellung "SSL erforderlich" auf der Standardwebsite aktiviert, wenn Sie das Zertifikat für IIS aktivieren. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diesen Schalter nicht verwenden und den Parameter Services verwenden, um das Zertifikat für IIS zu aktivieren, aktiviert der Befehl die Einstellung "SSL erforderlich" für die Standardwebsite in IIS.

Parametereigenschaften

Typ:	SwitchParameter
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

-Force

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.

Wenn Sie ein Zertifikat für SMTP aktivieren, werden Sie standardmäßig vom Befehl aufgefordert, das vorhandene, für SMTP aktivierte Zertifikat zu ersetzen, wobei es sich wahrscheinlich um das selbstsignierte Standardzertifikat von Exchange handelt.

Parametereigenschaften

Typ:	SwitchParameter
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

-Identity

Der Parameter "Identity" gibt das Zertifikat an, das Sie konfigurieren möchten. Gültige Werte sind:

ServerNameOrFQDN\Thumbprint
Thumbprint

Den Fingerabdruckwert können Sie mithilfe des Cmdlets Get-ExchangeCertificate abrufen.

Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter "Server".

Der Parameter "Thumbprint", und nicht der Parameter "Identity", ist der Positionsparameter für dieses Cmdlet. Wenn Sie daher einen Thumbprint-Wert allein angeben, verwendet der Befehl diesen Wert für den Thumbprint-Parameter.

Parametereigenschaften

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

Parametersätze

Identity

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

-NetworkServiceAllowed

Der Netzwerkdienst-Schalter gibt dem integrierten Netzwerkdienstkonto die Berechtigung, den privaten Schlüssel des Zertifikats zu lesen, ohne das Zertifikat für SMTP zu aktivieren. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:	SwitchParameter
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

-Server

Der Parameter "Server" gibt den Exchange-Server an, auf dem dieser Befehl ausgeführt werden soll. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:

Name
FQDN
Distinguished Name (DN)
Exchange-Legacy-DN

Exchange-Legacy-DN

Sie können diesen Parameter nicht mit dem Parameter Identity verwenden. Er kann jedoch mit dem Parameter Thumbprint verwendet werden.

Parametereigenschaften

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

Parametersätze

Thumbprint

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

-Services

Der Parameter Services gibt die Exchange-Dienste an, für die das Zertifikat aktiviert ist. Gültige Werte sind:

Partnerverbund: Verwenden Sie diesen Befehl nicht, um ein Zertifikat für den Verbund zu aktivieren. Wenn Sie eine Verbundvertrauensstellung erstellen oder ändern, wird die Art und Weise der Verwendung von Zertifikaten für einen Verbund aktiviert oder geändert. Sie verwalten die Zertifikate, die für Verbundvertrauensstellungen verwendet werden, mit den Cmdlets New-FederationTrust und Set-FederationTrust.
IIS: Wenn Sie ein Zertifikat für IIS aktivieren, ist die Einstellung "SSL erforderlich" auf der Standardwebsite in IIS standardmäßig konfiguriert. Um diese Änderung zu verhindern, verwenden Sie die Befehlszeilenoption "DoNotRequireSsl".
IMAP: Aktivieren Sie kein Platzhalterzertifikat für den IMAP4-Dienst. Verwenden Sie stattdessen das Cmdlet Set-ImapSettings, um den vollqualifizierten Domänennamen zu konfigurieren, den Clients zum Herstellen einer Verbindung mit dem IMAP4-Dienst verwenden.
POP: Aktivieren Sie kein Platzhalterzertifikat für den POP3-Dienst. Verwenden Sie stattdessen das Cmdlet Set-PopSettings zum Konfigurieren des vollqualifizierten Domänennamens, den Clients verwenden, um eine Verbindung zum POP3-Dienst herzustellen.
SMTP: Wenn Sie ein Zertifikat für SMTP aktivieren, werden Sie aufgefordert, das standardmäßige selbstsignierte Exchange-Zertifikat zu ersetzen, das zum Verschlüsseln des SMTP-Datenverkehrs zwischen internen Exchange verwendet wird. In der Regel müssen Sie das Standardzertifikat nicht durch ein Zertifikat einer kommerziellen Zertifizierungsstelle ersetzen, um internen SMTP-Datenverkehr zu verschlüsseln. Verwenden Sie den Switch Force, wenn Sie das Standardzertifikat ohne die Eingabeaufforderung ersetzen möchten.
UM: Sie können ein Zertifikat für den UM-Dienst nur aktivieren, wenn der Parameter UMStartupMode im Cmdlet Set-UMService auf TLS oder Dual festgelegt ist. Wenn der Parameter UMStartupMode auf den Standardwert TCP festgelegt ist, können Sie das Zertifikat für den UM-Dienst nicht aktivieren.
UMCallRouter: Sie können ein Zertifikat für den UM-Anruf-Router-Dienst nur aktivieren, wenn der UMStartupMode-Parameter im Cmdlet Set-UMCallRouterService auf TLS oder Dual festgelegt ist. Wenn der Parameter UMStartupMode auf den Standardwert TCP festgelegt ist, können Sie das Zertifikat nicht für den UM-Anrufweiterleitungsdienst aktivieren.

Es können mehrere Werte durch Kommata getrennt angegeben werden.

Die Werte, die Sie mit diesem Parameter angeben, sind additiv. Wenn Sie ein Zertifikat für einen oder mehrere Dienste aktivieren, verbleiben alle vorhandenen Dienste in der Eigenschaft Dienste, und Sie können die vorhandenen Dienste nicht entfernen. Konfigurieren Sie stattdessen ein anderes Zertifikat für die Dienste, und entfernen Sie dann das Zertifikat, das Sie nicht verwenden möchten.

Dienste weisen unterschiedliche Zertifikatanforderungen auf. Beispielsweise erfordern einige Dienste möglicherweise einen Servernamen in den Feldern "Antragstellername" oder "Alternativer Antragstellername" des Zertifikats, andere Dienste hingegen erfordern möglicherweise einen FQDN. Stellen Sie sicher, dass das Zertifikat die zu konfigurierenden Dienste unterstützt.

Parametereigenschaften

Typ:	AllowedServices
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

-Thumbprint

Der Thumbprint-Parameter gibt das Zertifikat an, das Sie konfigurieren möchten. Den Fingerabdruckwert können Sie mithilfe des Cmdlets Get-ExchangeCertificate abrufen.

Parametereigenschaften

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

Parametersätze

Thumbprint

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

-WhatIf

Der Schalter "WhatIf" zeigt die Funktion des Befehls an, 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.

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

Feedback

War diese Seite hilfreich?