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 cmdlet Get-PfxCertificate 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. Usa Invoke-Command para ejecutar un comando Get-PfxCertificate de forma remota.

Cuando el archivo de certificado PFX no está protegido con contraseña, el valor de la autenticación de parámetro 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. No se interpreta ningún carácter como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Tipo:	String[]
Alias:	PSPath, LP
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 archivo de certificado de .pfx.

Este parámetro se introdujo en PowerShell 6.1.

Nota

Para obtener más información sobre Protección de datos de secureString, consulte ¿Cómo es 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

Al usar el cmdlet Invoke-Command para ejecutar un comando de Get-PfxCertificate 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.