New-ExchangeCertificate

Modul:: Exchange PowerShell

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet New-ExchangeCertificate zum Erstellen und Erneuern von selbstsignierten Zertifikaten und zum Erstellen von Zertifikatsanforderungen (werden auch als Zertifikatsignieranforderungen (Certificate Signing Requests, CSRs) bezeichnet) für neue Zertifikate und Zertifikatserneuerungen von einer Zertifizierungsstelle.

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

Syntax

Request

New-ExchangeCertificate
    [-BinaryEncoded]
    [-GenerateRequest]
    [-RequestFile <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Force]
    [-FriendlyName <String>]
    [-IncludeAcceptedDomains]
    [-IncludeAutoDiscover]
    [-IncludeServerFQDN]
    [-IncludeServerNetBIOSName]
    [-Instance <X509Certificate2>]
    [-KeySize <Int32>]
    [-PrivateKeyExportable <Boolean>]
    [-Server <ServerIdParameter>]
    [-SubjectKeyIdentifier <String>]
    [-SubjectName <X500DistinguishedName>]
    [-WhatIf]
    [<CommonParameters>]

Certificate

New-ExchangeCertificate
    [-Services <AllowedServices>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Force]
    [-FriendlyName <String>]
    [-IncludeAcceptedDomains]
    [-IncludeAutoDiscover]
    [-IncludeServerFQDN]
    [-IncludeServerNetBIOSName]
    [-Instance <X509Certificate2>]
    [-KeySize <Int32>]
    [-PrivateKeyExportable <Boolean>]
    [-Server <ServerIdParameter>]
    [-SubjectKeyIdentifier <String>]
    [-SubjectName <X500DistinguishedName>]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Exchange verwendet Zertifikate für die TLS-Verschlüsselung (Transport Layer Security).

Beim Konfigurieren von Zertifikaten für TLS-Dienste 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

New-ExchangeCertificate

In diesem Beispiel wird ein selbstsigniertes Zertifikat mit den folgenden Einstellungen erstellt:

Der Wert für den Betreff lautet CN=<ServerName> (z. B. CN=Mailbox01).
Der Wert für Domains (alternative Antragstellernamen) ist <ServerName>,<ServerFQDN> (z. B Mailbox01,Mailbox01.contoso.com. ).
Der Wert für "Services" ist IMAP,POP,SMTP.
Der Dienstwert SMTP gewährt der lokalen Netzwerkdienste-Sicherheitsgruppe Lesezugriff auf den privaten Schlüssel des Zertifikats.
Der Wert "Dienste" SMTP und der Wert "Antragsteller", der den Servernamen enthält, veröffentlichen das Zertifikat in Active Directory, sodass die direkte Exchange-Vertrauensstellung die Authentizität des Servers für gegenseitiges TLS überprüfen kann.

Wenn dieses Zertifikat das vorhandene, selbstsignierte Zertifikat, das während des Exchange-Setups erstellt wurde, nicht ersetzen soll, klicken Sie auf "Nein" in der Eingabeaufforderung, in der Sie aufgefordert werden, das vorhandene SMTP-Standardzertifikat zu überschreiben.

Beispiel 2

Get-ExchangeCertificate -Thumbprint c4248cd7065c87cb942d60f7293feb7d533a4afc | New-ExchangeCertificate -PrivateKeyExportable $true

In diesem Beispiel wird gezeigt, wie ein Zertifikat mit einem bestimmten Fingerabdruckwert erneuert wird. Sie können den Fingerabdruckwert auf zwei Arten suchen:

Wählen Sie das Zertifikat im Exchange Admin Center und dann Bearbeiten aus, um die Eigenschaften des Zertifikats anzuzeigen. Der Fingerabdruckwert wird im Fenster "Exchange-Zertifikat" angezeigt.
Führen Sie das Cmdlet Get-ExchangeCertificate aus, um eine Liste aller auf dem Server installierten Zertifikate mit ihren Fingerabdruckwerten zurückzugeben.

Wenn Sie den Parameter PrivateKeyExportable auf den Wert $true festlegen, kann das erneuerte Zertifikat vom Server exportiert (und auf andere Server importiert werden).

Beispiel 3

New-ExchangeCertificate -GenerateRequest -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com -RequestFile "C:\Cert Requests\woodgrovebank.req"

In Exchange 2013 erstellt dieses Beispiel eine neue Zertifikatanforderung für eine Zertifizierungsstelle mit den folgenden Einstellungen:

Die Anforderung ist Base64-codiert.
Der Wert für den Betreff ist c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com.
Der Wert "Domänen (alternative Antragstellernamen)" enthält die zusätzlichen valuesautodiscover.woodgrovebank.com, mail.fabrikam.com und autodiscover.fabrikam.com.
Die Befehlsausgabe wird auf dem Bildschirm angezeigt und auch in die Textdatei C:\Cert Requests\woodgrovebank.req geschrieben.

Hinweis: Der Parameter RequestFile ist nur in Exchange 2013 verfügbar. Informationen zum Erstellen einer neuen Zertifikatanforderungsdatei in Exchange 2016 oder Exchange 2019 finden Sie in den Beispielen 4 und 5.

Nachdem Sie die Zertifikatanforderung erstellt haben, senden Sie die Ausgabe an die Zertifizierungsstelle. Nachdem Sie das Zertifikat von der Zertifizierungsstelle erhalten haben, installieren Sie das Zertifikat mithilfe des Import-ExchangeCertificate-Cmdlets und weisen es Exchange-Diensten zu, indem Sie das Enable-ExchangeCertificate-Cmdlet verwenden.

Wenn die Zertifizierungsstelle die Zertifikatanforderung in einer Datei verlangt, die durch DER codiert ist, verwenden Sie den BinaryEncoding-Schalter und speichern Sie die Datei mit der Erweiterung PFX.

Beispiel 4

$txtrequest = New-ExchangeCertificate -GenerateRequest -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com

[System.IO.File]::WriteAllBytes('\\FileServer01\Data\woodgrovebank.req', [System.Text.Encoding]::Unicode.GetBytes($txtrequest))

Dieses Beispiel erstellt eine neue Base64-codierte Zertifikatanforderung für eine Zertifizierungsstelle mit den gleichen Zertifikateinstellungen wie in Beispiel 3.

Diese Methode ist in Exchange 2016 und Exchange 2019 erforderlich, da der Parameter RequestFile nicht verfügbar ist.

Beispiel 5

$binrequest = New-ExchangeCertificate -GenerateRequest -BinaryEncoded -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com

[System.IO.File]::WriteAllBytes('\\FileServer01\Data\woodgrovebank.pfx', $binrequest.FileData)

Dieses Beispiel erstellt eine neue Anforderung eines DER-codierten (binären) Zertifikats für eine Zertifizierungsstelle mit den gleichen Zertifikateinstellungen wie in Beispiel 4.

Diese Methode ist in Exchange 2016 und Exchange 2019 erforderlich, da der Parameter RequestFile nicht verfügbar ist.

Beispiel 6

Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest -RequestFile "C:\Cert Requests\fabrikam_renewal.req"

In Exchange 2013 erstellt dieses Beispiel eine Anforderung zum Erneuern eines vorhandenen Zertifikats, das von einer Zertifizierungsstelle ausgestellt wurde. Die Zertifikatsanforderungen weist die folgenden Einstellungen auf:

Der Fingerabdruckswert des vorhandenen Zertifikats lautet 8A141F7F2BBA8041973399723BD2598D2ED2D831. Sie können mithilfe des Cmdlets Get-ExchangeCertificate nach dem Fingerabdruckwert suchen.
Die Anforderung ist Base64-codiert.
Die Ausgabe wird auf dem Bildschirm angezeigt und auch in die Textdatei C:\Cert Requests\fabrikam_renewal.req geschrieben.

Hinweis: Der Parameter RequestFile ist nur in Exchange 2013 verfügbar. Informationen zum Erstellen einer Anforderung zur Zertifikatsverlängerung für eine Zertifizierungsstelle in Exchange 2016 oder Exchange 2019 finden Sie in den Beispielen 7 und 8.

Nach dem Erstellen der Zertifikatserneuerungsanforderung senden Sie die Ausgabe an die Zertifizierungsstelle. Nachdem Sie das erneuerte Zertifikat von der Zertifizierungsstelle erhalten haben, installieren Sie das Zertifikat mithilfe des Cmdlets Import-ExchangeCertificate.

Beispiel 7

$txtrequest = Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest

[System.IO.File]::WriteAllBytes('C:\Cert Requests\fabrikam_renewal.req', [System.Text.Encoding]::Unicode.GetBytes($txtrequest))

In diesem Beispiel wird eine Base64-codierte Anforderungsdatei für die Zertifikaterneuerung für eine Zertifizierungsstelle erstellt, die die gleichen Zertifikateinstellungen wie in Beispiel 6 verwendet.

Diese Methode ist in Exchange 2016 und Exchange 2019 erforderlich, da der Parameter RequestFile nicht verfügbar ist.

Beispiel 8

$binrequest = Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest

[System.IO.File]::WriteAllBytes('C:\Cert Requests\fabrikam_renewal.pfx', $binrequest.FileData)

In diesem Beispiel wird eine neue Anforderungsdatei für die DER-codierte (binäre) Zertifikaterneuerung für eine Zertifizierungsstelle erstellt, die die gleichen Zertifikateinstellungen wie in Beispiel 7 verwendet.

Parameter

-BinaryEncoded

Der BinaryEncoded-Schalter gibt an, ob die Anforderung eines neuen Zertifikats mithilfe von Distinguished Encoding Rules (DER) codiert werden soll. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diesen Switch nicht verwenden, ist die Anforderung Base64-codiert.

Dieser Switch ist nur verfügbar, wenn Sie den Switch GenerateRequest verwenden.

Bei Base64-codierten Anforderungen senden Sie die Inhalte der Datei an die Zertifizierungsstelle. Bei durch DER codierten Anforderungen senden Sie die Zertifikatsdatei selbst.

Parametereigenschaften

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

Parametersätze

Request

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

-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

-DomainName

Der Parameter DomainName gibt einen oder mehrere FQDNs oder Servernamen für das Feld "Alternativer Antragstellername" (auch als "Alternativer Antragstellername" oder "SAN" bezeichnet) der Zertifikatanforderung oder des selbstsignierten Zertifikats an.

Wenn der Wert im Subject-Feld des Zertifikats nicht mit dem Zielservernamen oder dem vollqualifizierten Domänennamen übereinstimmt, sucht der Anforderer nach einer Übereinstimmung im Feld Subject Alternative Name.

Für gewöhnlich enthalten Werte Servernamen (beispielsweise „Mailbox01“) oder vollqualifizierte Domänennamen (beispielsweise „mail.contoso.com“). Es können mehrere Werte durch Kommata getrennt angegeben werden. Wertekönnen die Zeichen a bis z, 0 bis 9 und den Bindestrich (-) enthalten. Die Länge des Domänennamens darf 255 Zeichen nicht überschreiten.

Der Standardwert enthält den Namen und den FQDN des Exchange-Servers, wenn beide der folgenden Bedingungen erfüllt sind:

Sie verwenden diesen Parameter nicht.
Sie verwenden keinen dieser Parameter: IncludeAcceptedDomains, IncludeAutoDiscover, IncludeServerFQDN oder IncludeServerNetBIOSName.

Parametereigenschaften

Typ:	MultiValuedProperty
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.

Wenn Sie ein für SMTP (kein Services-Parameter oder der Services-Parameter enthält den Wert SMTP) aktiviertes selbstsigniertes Zertifikat erstellen, werden Sie standardmäßig aufgefordert, das vorhandene standardmäßige SMTP-Zertifikat durch das neue zu ersetzen, das Sie erstellen. Wenn Sie den Force-Switch verwenden, ersetzt das neue SMTP-Zertifikat automatisch das vorhandene SMTP-Zertifikat, ohne dass Sie gefragt werden.

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

-FriendlyName

Der Parameter FriendlyName gibt einen Anzeigenamen für die Zertifikatsanforderung oder das selbstsignierte Zertifikat an. Der Wert darf maximal 64 Zeichen lang sein.

Der Standardwert ist Microsoft Exchange. Der Wert des Anzeigenamens ist eine Beschreibung, und wirkt sich nicht auf die Funktionalität des Zertifikats aus.

Parametereigenschaften

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

-GenerateRequest

Der Switch GenerateRequest gibt an, dass Sie eine Zertifikatsanforderung für eine Zertifizierungsstelle erstellen. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diesen Schalter verwenden und die Ausgabe in eine Datei exportieren, wird eine PKCS #10-Zertifikatanforderung generiert, die Sie an die Zertifizierungsstelle senden. Wie Sie die Informationen senden, hängt von der Zertifizierungsstelle ab, aber in der Regel fügen Sie bei Base64-codierten Anforderungen den Inhalt in eine E-Mail-Nachricht oder in das Anforderungsformular auf der Website der Zertifizierungsstelle ein.

Nachdem Sie das Zertifikat von der Zertifizierungsstelle mithilfe des Import-ExchangeCertificate Cmdlets installiert haben, verwenden Sie das Enable-ExchangeCertficate Cmdlet, um das Zertifikat für Exchange-Dienste zu aktivieren.

Wenn Sie diese Befehlszeilenoption nicht verwenden, erstellt der Befehl ein neues selbstsigniertes Zertifikat auf dem Exchange-Server.

Parametereigenschaften

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

Parametersätze

Request

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

-IncludeAcceptedDomains

Die Option IncludeAcceptedDomains gibt an, dass alle akzeptierten Domänen in der Exchange-Organisation im Feld "Alternativer Antragstellername" der Zertifikatanforderung oder des selbstsignierten Zertifikats enthalten sind. Sie müssen keinen Wert für diese Option angeben.

Beim Verwenden dieses Switches:

Wenn Sie bereits eine akzeptierte Domäne im DomainName-Parameter verwenden, wird der Wert im Feld Subject Alternative Name nicht dupliziert.
Wenn Sie bei neuen selbstsignierten Zertifikaten den Parameter Dienste nicht verwenden, wird das Zertifikat nur SMTP zugewiesen.

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

-IncludeAutoDiscover

Der IncludeAutoDiscover-Schalter gibt an, ob für jede akzeptierte Domäne in der Exchange-organization ein alternativer Antragstellername-Wert mit dem Präfix autodiscover hinzugefügt werden soll. Sie müssen keinen Wert für diese Option angeben.

Wenn zur Organisation beispielsweise die akzeptierten Domänen woodgrovebank.com und woodgrovebank.co.uk zählen, führt die Verwendung dieses Switches zur Addition der folgenden Werte im Feld Subject Alternative Name:

autodiscover.woodgrovebank.com
autodiscover.woodgrovebank.co.uk

Beim Verwenden dieses Switches:

Wenn Sie den Wert autodiscover.<AcceptedDomain> bereits in den Parameter DomainName eingefügt haben, wird der Wert im Feld "Alternativer Antragstellername" nicht dupliziert.
Wenn Sie bei neuen selbstsignierten Zertifikaten den Parameter Dienste nicht verwenden, wird das Zertifikat nur SMTP zugewiesen.

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

-IncludeServerFQDN

Der IncludeServerFQDN-Schalter gibt an, dass der FQDN des Exchange-Servers im Feld "Alternativer Antragstellername" der neuen Zertifikatanforderung oder des neuen selbstsignierten Zertifikats enthalten ist. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diese Option verwenden und den FQDN des Servers bereits in den Parameter DomainName aufgenommen haben, wird der Wert nicht im Feld "Alternativer Antragstellername" dupliziert.

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

-IncludeServerNetBIOSName

Der Schalter IncludeServerNetBIOSName gibt an, dass der NetBIOS-Name des Exchange-Servers im Feld "Alternativer Antragstellername" der neuen Zertifikatanforderung oder des selbstsignierten Zertifikats enthalten ist. Sie müssen keinen Wert für diesen Switch angeben.

Wenn Sie diese Option verwenden und den NetBIOS-Namen des Servers bereits in den Parameter DomainName aufgenommen haben, wird der Wert nicht im Feld "Alternativer Antragstellername" dupliziert.

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

-Instance

Dieser Parameter ist veraltet und wird nicht mehr verwendet.

Parametereigenschaften

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

Parametersätze

(All)

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

-KeySize

Der Parameter KeySize gibt die Größe (in Bits) des öffentlichen RSA-Schlüssels an, der mit der neuen Zertifikatanforderung oder dem selbstsignierten Zertifikat verknüpft ist. Gültige Werte sind:

1024
2048 (Standardwert)
4096

Parametereigenschaften

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

-PrivateKeyExportable

Der Parameter PrivateKeyExportable gibt an, ob das Zertifikat über einen exportierbaren privaten Schlüssel verfügt, und steuert, ob Sie das Zertifikat vom Server exportieren (und auf andere Server importieren) können. Gültige Werte sind:

$true: Der private Schlüssel ist exportierbar, sodass Sie das Zertifikat vom Server exportieren können.
$false: Der private Schlüssel kann nicht exportiert werden, daher können Sie das Zertifikat nicht exportieren. Dieser Wert ist der Standardwert.

Parametereigenschaften

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

-RequestFile

Hinweis: Dieser Parameter wurde in den kumulativen H1-Updates 2022 aus Exchange 2016 und Exchange 2019 entfernt, da er UNC-Pfadwerte akzeptiert. Informationen zum Exportieren der Zertifikatanforderung in eine Datei ohne Verwendung des RequestFile-Parameters finden Sie unter Beispiel 4 und Beispiel 5 (neu) oder Beispiel 7 und Beispiel 8 (erneuern).

Dieser Parameter ist nur in Exchange 2013 verfügbar.

Der Parameter RequestFile gibt den Namen und den Pfad der Zertifikatsanforderungsdatei an. Die Datei enthält dieselben Informationen, die auf dem Bildschirm angezeigt werden, wenn Sie eine Base64-codierte Zertifikatsanforderung (der Switch BinaryEncoded wird von Ihnen nicht verwendet) generieren.

Sie können einen lokalen Pfad verwenden, wenn sich das Zertifikat oder die Zertifikatanforderung auf demselben Exchange-Server befindet, auf dem Sie den Befehl ausführen. Verwenden Sie andernfalls einen UNC-Pfad (\\Server\Share). Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Sie können diesen Parameter nur verwenden, wenn Sie den Switch GenerateRequest verwenden.

Parametereigenschaften

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

Parametersätze

Request

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

Parametereigenschaften

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

-Services

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

Keine: Sie können das Zertifikat später für Exchange-Dienste aktivieren, indem Sie das Enable-ExchangeCertificate Cmdlet verwenden.
Partnerverbund
IIS
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. Verwenden Sie den Switch Force, wenn Sie das Standardzertifikat ohne die Eingabeaufforderung ersetzen möchten.
UM: Dieser Wert erfordert, dass der Parameter UMStartupMode im Cmdlet Set-UMService auf TLS oder Dual festgelegt ist. Wenn der Parameter UMStartupMode auf den Standardwert von TCP festgelegt ist, können Sie das Zertifikat nicht für den UM-Dienst aktivieren.
UMCallRouter: Dieser Wert erfordert, dass der Parameter UMStartupMode 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 Standardwerte sind IMAP,POP und SMTP.

Sie können diesen Parameter nicht mit dem Switch GenerateRequest verwenden.

Nachdem Sie ein Zertifikat für einen Dienst aktiviert haben, können Sie den Dienst nicht mehr aus dem Zertifikat entfernen.

Parametereigenschaften

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

Parametersätze

Certificate

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

-SubjectKeyIdentifier

Der Parameter SubjectKeyIdentifier gibt den eindeutigen Schlüsselbezeichner des Antragstellers für ein neuesselbstsigniertes Zertifikat an. Führen Sie beispielsweise den Befehl $ski = [System.Guid]::NewGuid().ToString("N") aus, und verwenden Sie den Wert $ski für diesen Parameter.

Parametereigenschaften

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

-SubjectName

Der Parameter SubjectName gibt das Feld Subject der Zertifikatsanforderung oder des selbstsignierten Zertifikats an.

Für jedes Zertifikat ist ein Wert für das Feld Subject erforderlich, und nur ein Wert ist zulässig. Der Anforderer versucht, den Zielservernamen oder FQDN mit dem CN-Wert (allgemeiner Name, Common Name) des Antragstellers abzugleichen.

Dieser Parameter verwendet die Syntax: [C=CountryOrRegion,S=StateOrProvince,L=LocalityOrCity,O=Organization,OU=Department],CN=HostNameOrFQDN. Obwohl der einzige erforderliche Wert "" ist CN=HostNameOrFQDN, sollten Sie für Zertifikatanforderungen immer angeben C=CountryOrRegion , es können jedoch auch andere Werte von der Zertifizierungsstelle verlangt werden.

Wenn der Zertifikatantragsteller beispielsweise „mail.contoso.com“ in den USA sein soll, können Sie einen der folgenden Werte verwenden:

C=US,S=WA,L=Redmond,O=Contoso,OU=IT,CN=mail.contoso.com
C=US,O=Contoso,CN=mail.contoso.com
C=US,CN=mail.contoso.com

Wenn Sie diesen Parameter nicht verwenden, ist der Standardwert der Name des Exchange-Servers, auf dem Sie den Befehl ausführen (z. B. CN=Mailbox01).

Bei einem SAN-Zertifikat (Subject Alternative Name, alternativen Antragstellernamen) sollten Sie einen der Werte aus dem Parameter DomainName für die Verwendung im Wert SubjectName auswählen. Der von Ihnen für SubjectName anzugebende CN-Wert, wird automatisch in den DomainName-Werten verwendet.

Verwenden Sie für ein Platzhalterzertifikat einen SubjectName-Wert, der den Platzhalter (*) enthält. Zum Beispiel C=US,CN=*.contoso.com.

Parametereigenschaften

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

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?