Compartilhar via

Get-PfxCertificate

Módulo:
Microsoft.PowerShell.Security Module

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

Sintaxe

ByPath (Default) 

Get-PfxCertificate
    [-FilePath] <String[]>
    [<CommonParameters>]

ByLiteralPath 

Get-PfxCertificate
    -LiteralPath <String[]>
    [<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

PS C:\> 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 certificado Test.pfx no sistema.

Exemplo 2: obter um certificado .pfx de um computador remoto

PS C:\> 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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByPath
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-LiteralPath

O caminho completo para o arquivo .pfx do arquivo protegido. Ao contrário do parâmetro 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 Windows PowerShell para não interpretar nenhum caractere como sequências de escape.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:PSPath

Conjuntos de parâmetros

ByLiteralPath
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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.

Observações

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