Sdílet prostřednictvím

Get-PfxCertificate

  • Reference
Modul:
Microsoft.PowerShell.Security

Získá informace o souborech certifikátu PFX v počítači.

Syntaxe

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

Description

Rutina Get-PfxCertificate získá objekt představující každý zadaný soubor certifikátu PFX. Soubor PFX obsahuje certifikát i privátní klíč.

Příklady

Příklad 1: Získání certifikátu PFX

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

Tento příkaz získá informace o souboru certifikátu Test.pfx v systému.

Příklad 2: Získání certifikátu PFX ze vzdáleného počítače

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

Tento příkaz získá soubor certifikátu PFX ze vzdáleného počítače Serveru01. Používá Invoke-Command se ke vzdálenému Get-PfxCertificate spuštění příkazu.

Pokud soubor certifikátu PFX není chráněný heslem, hodnota ověřovacího parametru Invoke-Command musí být CredSSP.

Parametry

-FilePath

Určuje úplnou cestu k souboru PFX zabezpečeného souboru. Pokud zadáte hodnotu pro tento parametr, není nutné psát -FilePath na příkazovém řádku.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-LiteralPath

Úplná cesta k souboru PFX zabezpečeného souboru. Na rozdíl od FilePath se hodnota parametru LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

Typ:String[]
Aliasy:PSPath
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NoPromptForPassword

Potlačí výzvu k zadání hesla.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Password

Určuje heslo potřebné pro přístup .pfx k souboru certifikátu.

Tento parametr byl představen v PowerShellu 6.1.

Poznámka:

Další informace o ochraně dat SecureString naleznete v tématu Jak zabezpečený je SecureString?.

Typ:SecureString
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Řetězec, který obsahuje cestu k souboru, můžete převést na Get-PfxCertificate.

Výstupy

X509Certificate2

Get-PfxCertificate vrátí objekt pro každý certifikát, který získá.

Poznámky

Při použití rutiny Invoke-Command ke vzdálenému Get-PfxCertificate spuštění příkazu a soubor certifikátu PFX není chráněný heslem, hodnota parametru Invoke-Command Authentication musí být CredSSP.