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 Server01-Remotecomputer ab. Wird verwendet Invoke-Command , um einen Get-PfxCertificate Befehl remote auszuführen.

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Der vollständige Pfad zur PFX-Datei der gesicherten Datei. Im Gegensatz zu FilePath wird der Wert des LiteralPath-Parameters genau wie eingegeben verwendet. 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.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoPromptForPassword

Unterdrückt die Aufforderung zur Eingabe eines Kennworts.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-Daten finden Sie unter Wie sicher ist SecureString?.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können eine Zeichenfolge, die einen Dateipfad enthält, an übergeben Get-PfxCertificate.

Ausgaben

X509Certificate2

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

Hinweise

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