Get-PfxCertificate
Obtient des informations sur les fichiers de certificat PFX sur l’ordinateur.
Syntaxe
ByPath (Par défaut)
Get-PfxCertificate
[-FilePath] <String[]>
[-Password <SecureString>]
[-NoPromptForPassword]
[<CommonParameters>]
ByLiteralPath
Get-PfxCertificate
-LiteralPath <String[]>
[-Password <SecureString>]
[-NoPromptForPassword]
[<CommonParameters>]
Description
L’applet de commande Get-PfxCertificate 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 commande Get-PfxCertificate à distance.
Lorsque le fichier de certificat PFX n’est pas protégé par mot de passe, la valeur du paramètre Authentication 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 à la ligne de commande.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ByPath
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-LiteralPath
Chemin d'accès complet au 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | PSPath, DP |
Jeux de paramètres
ByLiteralPath
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-NoPromptForPassword
Supprime l’invite d’un mot de passe.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Password
Spécifie un mot de passe requis pour accéder à un fichier de certificat .pfx.
Ce paramètre a été introduit dans PowerShell 6.1.
Remarque
Pour plus d’informations sur la protection des données de SecureString, consultez Quelle est la sécurité de SecureString ?.
Propriétés du paramètre
| Type: | SecureString |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
String
Vous pouvez transmettre une chaîne contenant un chemin de fichier à Get-PfxCertificate.
Sorties
X509Certificate2
Get-PfxCertificate retourne un objet pour chaque certificat qu’il obtient.
Notes
Lorsque vous utilisez l’applet de commande Invoke-Command pour exécuter une commande Get-PfxCertificate à distance et que le fichier de certificat PFX n’est pas protégé par mot de passe, la valeur du paramètre Authentication de Invoke-Command doit être CredSSP.
