Get-AuthenticodeSignature

Article
01/13/2010

Obtient les informations relatives à la signature Authenticode d'un fichier.

Syntaxe

Get-AuthenticodeSignature [-FilePath] <string[]> [<CommonParameters>]

Description

L'applet de commande Get-AuthenticodeSignature obtient les informations relatives à la signature Authenticode d'un fichier. Si le fichier n'est pas signé, les informations sont récupérées, mais les champs ne sont pas renseignés.

Paramètres

-FilePath <string[]>

Spécifie le chemin d'accès au fichier examiné. Les caractères génériques sont autorisés, mais doivent mener à un seul fichier. Le nom de paramètre (« FilePath ») est facultatif.

Obligatoire ?	true
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByValue, ByPropertyName)
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.String

Vous pouvez diriger une chaîne contenant le chemin d'accès d'un fichier vers Get-AuthenticodeSignature.

Sorties

System.Management.Automation.Signature

Get-AuthenticodeSignature retourne un objet de signature pour chaque signature qu'il obtient.

Remarques

Pour plus d'informations sur les signatures Authenticode dans Windows PowerShell, consultez about_Signing.

Exemple 1

C:\PS>get-AuthenticodeSignature -filepath C:\Test\NewScript.ps1

Description
-----------
Cette commande obtient les informations relatives à la signature Authenticode du fichier NewScript.ps1. Elle utilise le paramètre FilePath pour spécifier le fichier.

Exemple 2

C:\PS>get-authenticodesignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1

Description
-----------
Cette commande obtient les informations relatives à la signature Authenticode des quatre fichiers dont la liste est fournie à la ligne de commande. Dans cette commande, le nom du paramètre FilePath, qui est facultatif, est omis.

Exemple 3

C:\PS>get-childitem $pshome\*.* | foreach-object {Get-AuthenticodeSignature $_} | where {$_.status -eq "Valid"}

Description
-----------
Cette commande répertorie tous les fichiers du répertoire $pshome ayant une signature Authenticode valide. La variable automatique $pshome contient le chemin d'accès au répertoire d'installation de Windows PowerShell.

La commande utilise l'applet de commande Get-ChildItem pour obtenir les fichiers du répertoire $pshome. Elle utilise le modèle *.* pour exclure les répertoires (bien qu'elle exclue également les fichiers ne comportant pas de point dans leur nom).

La commande utilise un opérateur de pipeline (|) pour envoyer les fichiers de la variable $pshome à l'applet de commande Foreach-Object, où l'applet de commande Get-AuthenticodeSignature est appelée pour chaque fichier. 

Les résultats de la commande Get-AuthenticodeSignature sont envoyés à une commande Where-Object qui sélectionne uniquement les objets signatures ayant l'état « Valid ».

Voir aussi

Concepts

about_Signing
about_Execution_Policies
Set-AuthenticodeSignature
Get-ExecutionPolicy
Set-ExecutionPolicy

Partager via