Partilhar 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

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 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 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 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, LP
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 certificado .pfx.

Esse parâmetro foi introduzido no PowerShell 6.1.

Observação

Para obter mais informações sobre SecureString proteção de dados, 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 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 Authentication de Invoke-Command deve ser CredSSP.