Compartilhar via

Get-PfxCertificate

Módulo:
Microsoft.PowerShell.Security Module

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

Sintaxe

ByPath (Padrão) 

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

ByLiteralPath 

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.

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 indicam ao PowerShell que não deve interpretar nenhum caractere como uma sequência de escape.

Propriedades do parâmetro

Tipo:

String[]

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

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

-NoPromptForPassword

Suprime a solicitação de uma senha.

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 a proteção de dados do SecureString, consulte Quão seguro é o SecureString?.

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
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 enviar uma string 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 para executar um comando remotamente e o arquivo de certificado PFX não estiver protegido por senha, o valor do parâmetro de Autenticação de deve ser CredSSP.