Udostępnij za pośrednictwem

Get-PfxCertificate

  • Odwołanie
Moduł:
Microsoft.PowerShell.Security

Pobiera informacje o plikach certyfikatów PFX na komputerze.

Składnia

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

Opis

Polecenie Get-PfxCertificate cmdlet pobiera obiekt reprezentujący każdy określony plik certyfikatu PFX. Plik PFX zawiera zarówno certyfikat, jak i klucz prywatny.

Przykłady

Przykład 1. Pobieranie certyfikatu 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

To polecenie pobiera informacje o pliku certyfikatu Test.pfx w systemie.

Przykład 2. Pobieranie certyfikatu PFX z komputera zdalnego

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

To polecenie pobiera plik certyfikatu PFX z komputera zdalnego Serwera01. Służy Invoke-Command do zdalnego uruchamiania Get-PfxCertificate polecenia.

Jeśli plik certyfikatu PFX nie jest chroniony hasłem, wartość parametru Invoke-Command Uwierzytelniania musi mieć wartość CredSSP.

Parametry

-FilePath

Określa pełną ścieżkę do pliku PFX zabezpieczonego pliku. Jeśli określisz wartość dla tego parametru, nie trzeba wpisywać -FilePath w wierszu polecenia.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LiteralPath

Pełna ścieżka do pliku PFX zabezpieczonego pliku. W przeciwieństwie do parametru FilePath wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Typ:String[]
Aliasy:PSPath
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-NoPromptForPassword

Pomija monitowanie o podanie hasła.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Password

Określa hasło wymagane do uzyskania dostępu do pliku certyfikatu .pfx .

Ten parametr został wprowadzony w programie PowerShell 6.1.

Uwaga

Aby uzyskać więcej informacji na temat ochrony danych SecureString , zobacz Jak bezpieczny jest protokół SecureString?.

Typ:SecureString
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Ciąg zawierający ścieżkę do pliku można przekazać potokiem .Get-PfxCertificate

Dane wyjściowe

X509Certificate2

Get-PfxCertificate Zwraca obiekt dla każdego odbieranego certyfikatu.

Uwagi

Jeśli używasz Invoke-Command polecenia cmdlet do zdalnego uruchamiania Get-PfxCertificate polecenia, a plik certyfikatu PFX nie jest chroniony hasłem, wartość parametru Invoke-Command Uwierzytelniania musi być CredSSP.