Get-PfxCertificate

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

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

Syntax

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 é 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.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 caractere 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.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoPromptForPassword

Suprime a solicitação de uma senha.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

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

Esse parâmetro foi introduzido no PowerShell 6.1.

Observação

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

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 ele obtém.

Observações

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.