Get-ExchangeCertificate
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-06-28
Mithilfe des Cmdlets Get-ExchangeCertificate können Sie Zertifikate anzeigen, die sich im lokalen Zertifikatspeicher befinden.
Syntax
Get-ExchangeCertificate [-Thumbprint <String>] [-DomainName <MultiValuedProperty>]
Get-ExchangeCertificate [-DomainName <MultiValuedProperty>] [-Instance <X509Certificate2>]
Detaillierte Beschreibung
Damit Sie das Cmdlet Get-ExchangeCertificate ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Administrator mit Leserechten
Um das Cmdlet Get-ExchangeCertificate auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
DomainName |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Verwenden Sie diesen Parameter, um alle Zertifikate zurückzugeben, die den Domänennamen enthalten, den Sie in den Feldern zum Betreffnamen bzw. zum Alternativbetreffnamen angeben. |
Instance |
Optional |
System.Security.Cryptography.X509Certificates.X509Certificate2 |
Verwenden Sie diesen Parameter, um dem zu verarbeitenden Befehl ein vollständiges Objekt zu übergeben. Dieser Parameter wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss. |
Thumbprint |
Optional |
System.String |
Verwenden Sie diesen Parameter, um das Zertifikat mit einem entsprechenden Fingerabdruck zurückzugeben. Jedes Zertifikat enthält einen Fingerabdruck, der als Digest für die zertifizierten Daten dient. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
Beispiel
Das erste Beispiel gibt alle Zertifikate zurück, die im Zertifikatspeicher des lokalen Computers gespeichert sind.
Das zweite Beispiel gibt die Details zu einem bestimmten Zertifikat, das im im Zertifikatspeicher des lokalen Computers gespeichert ist, als formatierte Liste zurück.
Hinweis
Der Parameter Thumbprint ist ein Positionsparameter, daher muss nur der Wert Thumbprint zur Verfügung gestellt werden.
Das dritte Beispiel zeigt, welches Zertifikat Exchange für den Domänennamen mail.contoso.com auswählt. Ein Sende- oder Empfangsconnector wählt das zu verwendende Zertifikat basierend auf dem FQDN des Connectors aus. Wenn mehrere Zertifikate mit dem gleichen FQDN vorhanden sind, können Sie mithilfe des Parameters DomainName ermitteln, welches Zertifikat Exchange auswählt. Das erste zurückgegebene Zertifikat ist das Zertifikat, das Exchange auswählt.
Get-ExchangeCertificate
Get-ExchangeCertificate 5113ae0233a72fccb75b1d0198628675333d010e | fl
Get-ExchangeCertificate -DomainName mail1.contoso.com