Get-AuthenticodeSignature
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
Cette applet de commande est disponible uniquement sur la plateforme Windows.
L’applet Get-AuthenticodeSignature
de commande obtient des informations sur la signature Authenticode pour un fichier ou un contenu de fichier sous forme de tableau d’octets.
Si le fichier est à la fois signé incorporé et que le catalogue Windows est signé, la signature du catalogue Windows est utilisée.
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 sur 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 les 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
elle est appelée 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 . Avant PowerShell 7.4, 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 comme il est typé. 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 de 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 le contenu dans lequel 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
Vous pouvez diriger une chaîne qui contient un chemin d’accès de fichier à cette applet de commande.
Sorties
Cette applet de commande 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.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour