Compartir a través de

Get-PfxCertificate

  • Referencia
Módulo:
Microsoft.PowerShell.Security

Obtiene información sobre los archivos de certificado PFX en el equipo.

Sintaxis

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

Description

El Get-PfxCertificate cmdlet obtiene un objeto que representa cada archivo de certificado PFX especificado. Un archivo PFX incluye el certificado y una clave privada.

Ejemplos

Ejemplo 1: Obtención de un 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 obtiene información sobre el archivo de certificado Test.pfx en el sistema.

Ejemplo 2: Obtención de un certificado PFX desde un equipo remoto

Invoke-Command -ComputerName "Server01" -ScriptBlock {Get-PfxCertificate -FilePath "C:\Text\TestNoPassword.pfx"} -Authentication CredSSP

Este comando obtiene un archivo de certificado PFX del equipo remoto Server01. Invoke-Command Usa para ejecutar un Get-PfxCertificate comando de forma remota.

Cuando el archivo de certificado PFX no está protegido con contraseña, el valor del parámetro Authentication de Invoke-Command debe ser CredSSP.

Parámetros

-FilePath

Especifica la ruta de acceso completa al archivo PFX del archivo protegido. Si especifica un valor para este parámetro, no es necesario escribir -FilePath en la línea de comandos.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-LiteralPath

Ruta de acceso completa al archivo PFX del archivo protegido. A diferencia de FilePath, el valor del parámetro LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Tipo:String[]
Alias:PSPath
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-NoPromptForPassword

Suprime la solicitud de una contraseña.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Password

Especifica una contraseña necesaria para acceder a un .pfx archivo de certificado.

Este parámetro se introdujo en PowerShell 6.1.

Nota:

Para obtener más información sobre la protección de datos SecureString , consulte ¿Cómo es secure is SecureString?.

Tipo:SecureString
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contiene una ruta de acceso de archivo a Get-PfxCertificate.

Salidas

X509Certificate2

Get-PfxCertificate devuelve un objeto para cada certificado que obtiene.

Notas

Cuando se usa el Invoke-Command cmdlet para ejecutar un Get-PfxCertificate comando de forma remota y el archivo de certificado PFX no está protegido con contraseña, el valor del parámetro Authentication de Invoke-Command debe ser CredSSP.