Get-AuthenticodeSignature

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

Obtient des informations sur la signature Authenticode pour un fichier.

Syntax

Get-AuthenticodeSignature
   [-FilePath] <String[]>
   [<CommonParameters>]
Get-AuthenticodeSignature
   -LiteralPath <String[]>
   [<CommonParameters>]
Get-AuthenticodeSignature
   -SourcePathOrExtension <String[]>
   -Content <Byte[]>
   [<CommonParameters>]

Description

L’applet Get-AuthenticodeSignature de commande obtient des informations sur la signature Authenticode pour un fichier ou un contenu de fichier en tant que tableau d’octets. Si le fichier n'est pas signé, les informations sont récupérées, mais les champs sont vides.

Exemples

Exemple 1 : Obtenir la signature Authenticode pour un fichier

Get-AuthenticodeSignature -FilePath "C:\Test\NewScript.ps1"

Cette commande obtient des informations sur la signature Authenticode dans le fichier NewScript.ps1. Il utilise le paramètre FilePath pour spécifier le fichier.

Exemple 2 : Obtenir la signature Authenticode pour plusieurs fichiers

Get-AuthenticodeSignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1

Cette commande obtient des informations sur la signature Authenticode pour les quatre fichiers répertoriés dans la ligne de commande. Dans cet exemple, le nom du paramètre FilePath , facultatif, est omis.

Exemple 3 : Obtenir uniquement des signatures Authenticode valides pour plusieurs fichiers

Get-ChildItem $PSHOME\*.* | ForEach-object {Get-AuthenticodeSignature $_} | Where-Object {$_.status -eq "Valid"}

Cette commande répertorie tous les fichiers du $PSHOME répertoire qui ont une signature Authenticode valide. La $PSHOME variable automatique contient le chemin d’accès au répertoire d’installation de PowerShell.

La commande utilise l’applet Get-ChildItem de commande pour obtenir les fichiers dans le $PSHOME répertoire. Il utilise un modèle de . pour exclure des répertoires (bien qu’il exclut également les fichiers sans point dans le nom de fichier).

La commande utilise un opérateur de pipeline (|) pour envoyer les fichiers à $PSHOME l’applet ForEach-Object de commande, où Get-AuthenticodeSignature il est appelé pour chaque fichier.

Les résultats de la Get-AuthenticodeSignature commande sont envoyés à une Where-Object commande qui sélectionne uniquement les objets de signature avec l’état Valide.

Exemple 4 : Obtenir la signature Authenticode pour un contenu de fichier spécifié en tant que tableau d’octets

Get-AuthenticodeSignature -Content (Get-Content foo.ps1 -AsByteStream) -SourcePathorExtension ps1

Cette commande obtient des informations sur la signature Authenticode pour le contenu d’un fichier. Dans cet exemple, l’extension de fichier est spécifiée avec le contenu du fichier.

Paramètres

-Content

Contenu d’un fichier sous forme de tableau d’octets pour lequel la signature Authenticode est récupérée. Ce paramètre doit être utilisé avec le paramètre SourcePathOrExtension . Le contenu du fichier doit être au format Unicode (UTF-16LE).

Type:Byte[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-FilePath

Spécifie le chemin d’accès au fichier à examiner. Les caractères génériques sont autorisés, mais ils doivent conduire à un seul fichier. Il n’est pas nécessaire de taper FilePath sur la ligne de commande lorsque vous spécifiez une valeur pour ce paramètre.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-LiteralPath

Spécifie le chemin d'accès au fichier à examiner. Contrairement à FilePath, la valeur du paramètre LiteralPath est utilisée exactement telle qu'elle est tapée. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin inclut un caractère d’échappement, placez-le entre guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter les caractères comme des caractères d’échappement.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourcePathOrExtension

Chemin d’accès au fichier ou au type de fichier du contenu pour lequel la signature Authenticode est récupérée. Ce paramètre est utilisé avec Content où le contenu du fichier est passé en tant que tableau d’octets.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

Vous pouvez diriger une chaîne qui contient un chemin d’accès au Get-AuthenticodeSignaturefichier .

Sorties

Signature

Get-AuthenticodeSignature retourne un objet de signature pour chaque signature qu’elle obtient.

Notes

Cette applet de commande est disponible uniquement sur les plateformes Windows.

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