Compartilhar via

Get-PfxCertificate

  • Referência
Módulo:
Microsoft.PowerShell.Security

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 cmdlet Get-PfxCertificate 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

Esse 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

Esse comando obtém um arquivo de certificado PFX do computador remoto Server01. Ele usa Invoke-Command para executar um comando Get-PfxCertificate 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 protegido. Se você especificar um valor para esse parâmetro, não será necessário digitar -FilePath na linha de comando.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LiteralPath

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

Tipo:String[]
Aliases:PSPath, LP
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoPromptForPassword

Suprime a solicitação de uma senha.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Password

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

Esse parâmetro foi introduzido no PowerShell 6.1.

Nota

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

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 que obtém.

Observações

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