Get-PfxCertificate

  • Référence
Module:
Microsoft.PowerShell.Security

Obtient des informations sur les fichiers de certificat PFX sur l’ordinateur.

Syntaxe

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

Description

L’applet Get-PfxCertificate de commande obtient un objet représentant chaque fichier de certificat PFX spécifié. Un fichier PFX inclut à la fois le certificat et une clé privée.

Exemples

Exemple 1 : Obtenir un certificat 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

Cette commande obtient des informations sur le fichier de certificat Test.pfx sur le système.

Exemple 2 : Obtenir un certificat PFX à partir d’un ordinateur distant

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

Cette commande obtient un fichier de certificat PFX à partir de l’ordinateur distant Server01. Il utilise Invoke-Command pour exécuter une Get-PfxCertificate commande à distance.

Lorsque le fichier de certificat PFX n’est pas protégé par mot de passe, la valeur du paramètre d’authentification de Invoke-Command doit être CredSSP.

Paramètres

-FilePath

Spécifie le chemin d’accès complet au fichier PFX du fichier sécurisé. Si vous spécifiez une valeur pour ce paramètre, il n’est pas nécessaire de taper -FilePath sur la ligne de commande.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LiteralPath

Chemin complet du fichier PFX du fichier sécurisé. Contrairement à FilePath, la valeur du paramètre LiteralPath est utilisée exactement comme il est typé. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin d’accès inclut des caractères d’échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Type:String[]
Alias:PSPath
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NoPromptForPassword

Supprime l’invite d’un mot de passe.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Password

Spécifie un mot de passe requis pour accéder à un .pfx fichier de certificat.

Ce paramètre a été introduit dans PowerShell 6.1.

Remarque

Pour plus d’informations sur la protection des données SecureString , consultez Comment secure is SecureString ?.

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger une chaîne contenant un chemin d’accès au Get-PfxCertificatefichier .

Sorties

X509Certificate2

Get-PfxCertificate retourne un objet pour chaque certificat qu’il obtient.

Notes

Lorsque vous utilisez l’applet Invoke-Command de commande pour exécuter une Get-PfxCertificate commande à distance et que le fichier de certificat PFX n’est pas protégé par mot de passe, la valeur du paramètre d’authentification de Invoke-Command doit être CredSSP.