Get-PfxCertificate

Referenz

Modul:: Microsoft.PowerShell.Security

Ruft Informationen zu PFX-Zertifikatdateien auf dem Computer ab.

Syntax

Get-PfxCertificate
   [-FilePath] <String[]>
   [-Password <SecureString>]
   [-NoPromptForPassword]
   [<CommonParameters>]

Get-PfxCertificate
   -LiteralPath <String[]>
   [-Password <SecureString>]
   [-NoPromptForPassword]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-PfxCertificate ruft ein Objekt ab, das jede angegebene PFX-Zertifikatdatei darstellt. Eine PFX-Datei enthält sowohl das Zertifikat als auch einen privaten Schlüssel.

Beispiele

Beispiel 1: Abrufen eines PFX-Zertifikats

Get-PfxCertificate -FilePath "C:\windows\system32\Test.pfx"

Password: ******
Signer Certificate:      David Chew (Self Certificate)
Time Certificate:
Time Stamp:
Path:                    C:\windows\system32\zap.pfx

Dieser Befehl ruft Informationen zur Zertifikatdatei "Test.pfx" im System ab.

Beispiel 2: Abrufen eines PFX-Zertifikats von einem Remotecomputer

Invoke-Command -ComputerName "Server01" -ScriptBlock {Get-PfxCertificate -FilePath "C:\Text\TestNoPassword.pfx"} -Authentication CredSSP

Dieser Befehl ruft eine PFX-Zertifikatdatei vom Remotecomputer Server01 ab. Sie verwendet Invoke-Command, um einen Get-PfxCertificate Befehl remote auszuführen.

Wenn die PFX-Zertifikatdatei nicht kennwortgeschützt ist, muss der Wert des Authentication Parameter von Invoke-Command CredSSP sein.

Parameter

-FilePath

Gibt den vollständigen Pfad zur PFX-Datei der gesicherten Datei an. Wenn Sie einen Wert für diesen Parameter angeben, ist es nicht erforderlich, -FilePath an der Befehlszeile einzugeben.

Typ:	String[]
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-LiteralPath

Der vollständige Pfad zur PFX-Datei der gesicherten Datei. Im Gegensatz zu FilePath-wird der Wert des LiteralPath--Parameters genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie ihn in einfache Anführungszeichen ein. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Typ:	String[]
Aliase:	PSPath, LP
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-NoPromptForPassword

Unterdrückt die Aufforderung zum Eingeben eines Kennworts.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Password

Gibt ein Kennwort an, das für den Zugriff auf eine .pfx Zertifikatdatei erforderlich ist.

Dieser Parameter wurde in PowerShell 6.1 eingeführt.

Anmerkung

Weitere Informationen zu SecureString Datenschutz finden Sie unter Wie sicher ist SecureString?.

Typ:	SecureString
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

Sie können eine Zeichenfolge, die einen Dateipfad enthält, an Get-PfxCertificateweitergeleitet werden.

Ausgaben

X509Certificate2

Get-PfxCertificate gibt ein Objekt für jedes Zertifikat zurück, das es abruft.

Hinweise

Wenn Sie das Cmdlet Invoke-Command verwenden, um einen Get-PfxCertificate Befehl remote auszuführen, und die PFX-Zertifikatdatei ist nicht kennwortbeschützt, muss der Wert des Authentication-Parameters von Invoke-Command CredSSP sein.