Delen via

Get-PfxCertificate

Module:
Microsoft.PowerShell.Security Module

Haalt informatie op over PFX-certificaatbestanden op de computer.

Syntaxis

ByPath (Standaard) 

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

ByLiteralPath 

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

Description

De Get-PfxCertificate-cmdlet haalt een object op dat elk opgegeven PFX-certificaatbestand vertegenwoordigt. Een PFX-bestand bevat zowel het certificaat als een persoonlijke sleutel.

Voorbeelden

Voorbeeld 1: Een PFX-certificaat ophalen

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

Met deze opdracht wordt informatie opgehaald over het certificaatbestand Test.pfx op het systeem.

Voorbeeld 2: Een PFX-certificaat ophalen van een externe computer

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

Met deze opdracht wordt een PFX-certificaatbestand opgehaald van de externe Server01-computer. Er wordt Invoke-Command gebruikt om een Get-PfxCertificate opdracht op afstand uit te voeren.

Wanneer het PFX-certificaatbestand niet met een wachtwoord is beveiligd, moet de waarde van de parameter Authentication van Invoke-Command CredSSP zijn.

Parameters

-FilePath

Hiermee geeft u het volledige pad naar het PFX-bestand van het beveiligde bestand. Als u een waarde voor deze parameter opgeeft, hoeft u -FilePath niet op de opdrachtregel te typen.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByPath
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LiteralPath

Het volledige pad naar het PFX-bestand van het beveiligde bestand. In tegenstelling tot FilePath, wordt de waarde van de parameter LiteralPath exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, zet het dan tussen enkele aanhalingstekens. Enkele aanhalingstekens zorgen ervoor dat PowerShell geen tekens als escapesequenties interpreteert.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PSPath, LP

Parametersets

ByLiteralPath
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-NoPromptForPassword

Onderdrukt het vragen om een wachtwoord.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Password

Hiermee geeft u een wachtwoord op dat is vereist voor toegang tot een .pfx certificaatbestand.

Deze parameter is geïntroduceerd in PowerShell 6.1.

Opmerking

Zie voor meer informatie over SecureString gegevensbeveiliging Hoe veilig is SecureString?.

Parametereigenschappen

Type:SecureString
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

U kunt een tekenreeks die een bestandspad bevat doorsluisen naar Get-PfxCertificate.

Uitvoerwaarden

X509Certificate2

Get-PfxCertificate retourneert een object voor elk certificaat dat het ontvangt.

Notities

Wanneer u de cmdlet gebruikt om een -opdracht op afstand uit te voeren en het PFX-certificaatbestand niet met een wachtwoord is beveiligd, moet de waarde van de parameter Authentication van CredSSP zijn.