Get-PfxCertificate
Získá informace o souborech certifikátu PFX v počítači.
Syntaxe
ByPath (Výchozí)
Get-PfxCertificate
[-FilePath] <String[]>
[-Password <SecureString>]
[-NoPromptForPassword]
[<CommonParameters>]
ByLiteralPath
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 ke vzdálenému spuštění příkazu Get-PfxCertificate.
Pokud soubor certifikátu PFX není chráněný heslem, musí být hodnota parametru AuthenticationInvoke-Command CredSSP.
Parametry
-FilePath
Určuje úplnou cestu k souboru PFX zabezpečeného souboru. Pokud zadáte hodnotu pro tento parametr, není nutné zadat -FilePath na příkazovém řádku.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByPath
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Úplná cesta k souboru PFX zabezpečeného souboru. Na rozdíl od FilePathse hodnota parametru LiteralPath používá přesně tak, jak je zadán. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath, PO |
Sady parametrů
ByLiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-NoPromptForPassword
Potlačí výzvu k zadání hesla.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Password
Určuje heslo potřebné pro přístup k souboru certifikátu .pfx.
Tento parametr byl představen v PowerShellu 6.1.
Poznámka:
Další informace o ochraně dat SecureString najdete v tématu Jak zabezpečený je SecureString?.
Vlastnosti parametru
| Typ: | SecureString |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje cestu k souboru, můžete zamísit do 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 spuštění příkazu Get-PfxCertificate a soubor certifikátu PFX není chráněný heslem, hodnota parametru AuthenticationInvoke-Command musí být CredSSP.
