Partilhar via


Get-PfxCertificate

Obtém informações sobre arquivos de certificado PFX no computador.

Sintaxe

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

Description

O Get-PfxCertificate cmdlet obtém um objeto que representa cada arquivo de certificado PFX especificado. Um arquivo PFX inclui o certificado e uma chave privada.

Exemplos

Exemplo 1: Obter um certificado 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

Este comando obtém informações sobre o arquivo de certificado Test.pfx no sistema.

Exemplo 2: Obter um certificado PFX de um computador remoto

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

Este comando obtém um arquivo de certificado PFX do computador remoto Server01. Ele usa Invoke-Command para executar um Get-PfxCertificate comando remotamente.

Quando o arquivo de certificado PFX não está protegido por senha, o valor do parâmetro Authentication de Invoke-Command deve ser CredSSP.

Parâmetros

-FilePath

Especifica o caminho completo para o arquivo PFX do arquivo seguro. Se você especificar um valor para esse parâmetro, não será necessário digitar -FilePath na linha de comando.

Tipo:String[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LiteralPath

O caminho completo para o arquivo PFX do arquivo seguro. Ao contrário de FilePath, o valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Tipo:String[]
Aliases:PSPath
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-NoPromptForPassword

Suprime a solicitação de uma senha.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Password

Especifica uma senha necessária para acessar um arquivo de .pfx certificado.

Esse parâmetro foi introduzido no PowerShell 6.1.

Nota

Para obter mais informações sobre a proteção de dados do SecureString , consulte Quão seguro é o SecureString?.

Tipo:SecureString
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém um caminho de arquivo para Get-PfxCertificate.

Saídas

X509Certificate2

Get-PfxCertificate Retorna um objeto para cada certificado obtido.

Notas

Ao usar o Invoke-Command cmdlet para executar um Get-PfxCertificate comando remotamente e o arquivo de certificado PFX não estiver protegido por senha, o valor do parâmetro Authentication de Invoke-Command deve ser CredSSP.