Import-ExchangeCertificate

Syntax

Import-ExchangeCertificate
      -FileData <Byte[]>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-FriendlyName <String>]
      [-Password <SecureString>]
      [-PrivateKeyExportable <Boolean>]
      [-Server <ServerIdParameter>]
      [-WhatIf]
      [<CommonParameters>]

Import-ExchangeCertificate
      -Instance <String[]>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-FriendlyName <String>]
      [-Password <SecureString>]
      [-PrivateKeyExportable <Boolean>]
      [-Server <ServerIdParameter>]
      [-WhatIf]
      [<CommonParameters>]

Import-ExchangeCertificate
      -FileName <String>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-FriendlyName <String>]
      [-Password <SecureString>]
      [-PrivateKeyExportable <Boolean>]
      [-Server <ServerIdParameter>]
      [-WhatIf]
      [<CommonParameters>]

Beschreibung

Sie können das Cmdlet Import-ExchangeCertificate verwenden, um die folgenden Arten von Zertifikatdateien auf einem Exchange-Server zu importieren:

• Eine PKCS #7-Zertifikats- oder Zertifikatskettendatei (P7B oder P7C), die durch eine Zertifizierungsstelle (Certification Authority, CA) ausgestellt wurde. Bei PKCS #7 handelt es sich um einen Syntaxstandard kryptographischer Meldungen, eine Syntax, die für digitales Signieren oder Verschlüsseln von Daten mit einer Kryptografie mit öffentlichen Schlüsseln, einschließlich Zertifikaten, verwendet wird. Weitere Informationen finden Sie unter PKCS #7 Kryptografische Messagingsyntaxkonzepte.
• Eine PKCS #12-Zertifikatsdatei (CER, CRT, DER, P12 oder PFX), die den privaten Schlüssel enthält. Bei PKCS #12 handelt es sich um den Standard für die Syntax beim Austausch von vertraulichen Informationen, ein zum Speichern von Zertifikaten mit den entsprechenden kennwortgeschützten Schlüsseln verwendetes Dateiformat. Weitere Informationen finden Sie unter PKCS #12: Personal Information Exchange Syntax v1.1.

Nachdem Sie ein Zertifikat auf einem Exchange-Server importiert haben, müssen Sie das Zertifikat mithilfe des Cmdlets Enable-ExchangeCertificate einem oder mehreren Exchange-Diensten zuweisen.

Bei der Konfiguration von Zertifikaten für TLS- (Transport Layer Security) und SSL-Dienste (Secure Sockets Layer) sind eine Reihe von Faktoren zu beachten. 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.

Secure Sockets Layer (SSL) wird durch Transport Layer Security (TLS) als Protokoll ersetzt, das zum Verschlüsseln von Daten verwendet wird, die zwischen Computersystemen gesendet werden. Sie sind so eng miteinander verbunden, dass die Begriffe "SSL" und "TLS" (ohne Versionen) häufig synonym verwendet werden. Aufgrund dieser Ähnlichkeit wurden Verweise auf "SSL" in Exchange-Themen, das Exchange Admin Center und die Exchange-Verwaltungsshell häufig verwendet, um sowohl das SSL- als auch das TLS-Protokoll zu umfassen. „SSL“ bezieht sich in der Regel nur dann auf das eigentliche SSL-Protokoll, wenn auch eine Version angegeben wird (z. B. SSL 3.0). Weitere Informationen finden Sie unter Exchange Server bewährte Methoden für die TLS-Konfiguration.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den 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

Import-ExchangeCertificate -Server Mailbox01 -FileName "\\FileServer01\Data\Exported Fabrikam Cert.pfx" -Password (Get-Credential).password

In Exchange 2013 importiert dieses Beispiel das Zertifikat aus der PKCS #12-Datei aus \\FileServer01\Data\Exported Fabrikam Cert.pfx auf den Exchange-Server mailbox01. Für diese Datei ist das Kennwort der Datei erforderlich. Dieses Zertifikat könnte von einem anderen Server exportiert oder von einer Zertifizierungsstelle ausgestellt worden sein.

Verwenden Sie zum Exportieren des Zertifikats in Exchange 2016 oder Exchange 2019 den FileData-Parameter, wie in Beispiel 2 beschrieben.

Beispiel 2

Import-ExchangeCertificate -Server Mailbox01 -FileData ([System.IO.File]::ReadAllBytes('\\FileServer01\Data\Exported Fabrikam Cert.pfx')) -Password (Get-Credential).password

In diesem Beispiel wird die gleiche Zertifikatdatei aus Beispiel 1 importiert. Diese Methode ist in Exchange 2016 und Exchange 2019 erforderlich, da der FileName-Parameter nicht verfügbar ist.

Beispiel 3

Import-ExchangeCertificate -FileData ([System.IO.File]::ReadAllBytes('C:\Certificates\Fabrikam IssuedCert.p7b'))

In diesem Beispiel wird eine Kette von Zertifikaten aus der PKCS #7-Datei C:\Certificates\Fabrikam IssuedCert.p7b auf dem lokalen Exchange-Server importiert.

Parameter

-Confirm

-DomainController

-FileData

-FileName

-FriendlyName

-Instance

-Password

-PrivateKeyExportable

-Server

-WhatIf

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, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.