Freigeben über

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 Get-PfxCertificate Cmdlet 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. Es wird Invoke-Command verwendet, um einen Get-PfxCertificate Befehl remote auszuführen.

Wenn die PFX-Zertifikatdatei nicht kennwortgeschützt ist, muss der Wert des Authentifizierungsparameters 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, an der Befehlszeile einzugeben -FilePath .

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 Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Typ:String[]
Aliase:PSPath
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.

Hinweis

Weitere Informationen zum Schutz von SecureString 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 übergeben, die einen Dateipfad enthält.Get-PfxCertificate

Ausgaben

X509Certificate2

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

Hinweise

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