Dela via


Get-PfxCertificate

Hämtar information om PFX-certifikatfiler på datorn.

Syntax

ByPath (Standard)

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

ByLiteralPath

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

Description

Cmdleten Get-PfxCertificate hämtar ett objekt som representerar varje angiven PFX-certifikatfil. En PFX-fil innehåller både certifikatet och en privat nyckel.

Exempel

Exempel 1: Hämta ett PFX-certifikat

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

Det här kommandot hämtar information om test.pfx-certifikatfilen i systemet.

Exempel 2: Hämta ett PFX-certifikat från en fjärrdator

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

Det här kommandot hämtar en PFX-certifikatfil från server01-fjärrdatorn. Den använder Invoke-Command för att fjärrköra ett Get-PfxCertificate kommando.

När PFX-certifikatfilen inte är lösenordsskyddad måste värdet för parametern Authentication för Invoke-Command vara CredSSP.

Parametrar

-FilePath

Anger den fullständiga sökvägen till PFX-filen för den skyddade filen. Om du anger ett värde för den här parametern behöver du inte skriva -FilePath på kommandoraden.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ByPath
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LiteralPath

Den fullständiga sökvägen till PFX-filen för den skyddade filen. Till skillnad från FilePathanvänds värdet för parametern LiteralPath precis som det skrivs. Inga tecken tolkas som wildcards. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PSPath, SP

Parameteruppsättningar

ByLiteralPath
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NoPromptForPassword

Undertrycker att fråga efter ett lösenord.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Password

Anger ett lösenord som krävs för att komma åt en .pfx certifikatfil.

Den här parametern introducerades i PowerShell 6.1.

Anmärkning

Mer information om SecureString dataskydd finns i Hur säker är SecureString?.

Parameteregenskaper

Typ:SecureString
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Du kan skicka en sträng som innehåller en filsökväg till Get-PfxCertificate.

Utdata

X509Certificate2

Get-PfxCertificate returnerar ett objekt för varje certifikat som det får.

Kommentarer

När du använder Invoke-Command-cmdleten för att fjärrköra ett Get-PfxCertificate-kommando, och PFX-certifikatfilen inte är lösenordsskyddad, måste värdet för parametern Authentication för Invoke-Command vara CredSSP.