Set-AuthenticodeSignature
Ajoute une signature Authenticode à un script PowerShell ou à un autre fichier.
Syntaxe
Set-AuthenticodeSignature
[-Certificate] <X509Certificate2>
[-IncludeChain <String>]
[-TimestampServer <String>]
[-HashAlgorithm <String>]
[-Force]
[-FilePath] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AuthenticodeSignature
[-Certificate] <X509Certificate2>
[-IncludeChain <String>]
[-TimestampServer <String>]
[-HashAlgorithm <String>]
[-Force]
-LiteralPath <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AuthenticodeSignature
[-Certificate] <X509Certificate2>
[-IncludeChain <String>]
[-TimestampServer <String>]
[-HashAlgorithm <String>]
[-Force]
-SourcePathOrExtension <String[]>
-Content <Byte[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Cette applet de commande est disponible uniquement sur la plateforme Windows.
L’applet de commande Set-AuthenticodeSignature ajoute une signature Authenticode à n’importe quel fichier prenant en charge sip (Subject Interface Package).
Dans un fichier de script PowerShell, la signature prend la forme d’un bloc de texte qui indique la fin des instructions exécutées dans le script. S’il existe une signature dans le fichier lors de l’exécution de cette applet de commande, cette signature est supprimée.
Exemples
Exemple 1 : signer un script à l’aide d’un certificat à partir du magasin de certificats local
Ces commandes récupèrent un certificat de signature de code auprès du fournisseur de certificats PowerShell et l’utilisent pour signer un script PowerShell.
$cert=Get-ChildItem -Path Cert:\CurrentUser\My -CodeSigningCert
Set-AuthenticodeSignature -FilePath PsTestInternet2.ps1 -Certificate $certLa première commande utilise l’applet de commande Get-ChildItem et le fournisseur de certificats PowerShell pour obtenir les certificats dans le sous-répertoire Cert:\CurrentUser\My du magasin de certificats. Le lecteur Cert: est le lecteur exposé par le fournisseur de certificats. Le paramètre CodeSigningCert, pris en charge uniquement par le fournisseur de certificats, limite les certificats récupérés à ceux avec l’autorité de signature de code. La commande stocke le résultat dans la variable $cert.
La deuxième commande utilise l’applet de commande Set-AuthenticodeSignature pour signer le script PSTestInternet2.ps1. Il utilise le paramètre FilePath pour spécifier le nom du script et le paramètre Certificate pour spécifier que le certificat est stocké dans la variable $cert.
Note
L’utilisation du paramètre CodeSigningCert avec Get-ChildItem retourne uniquement les certificats qui ont une autorité de signature de code et contiennent une clé privée. S’il n’existe aucune clé privée, les certificats ne peuvent pas être utilisés pour la signature.
Exemple 2 : signer un script à l’aide d’un certificat à partir d’un fichier PFX
Ces commandes utilisent l’applet de commande Get-PfxCertificate pour charger un certificat de signature de code. Ensuite, utilisez-le pour signer un script PowerShell.
$cert = Get-PfxCertificate -FilePath C:\Test\Mysign.pfx
Set-AuthenticodeSignature -FilePath ServerProps.ps1 -Certificate $certLa première commande utilise l’applet de commande Get-PfxCertificate pour charger le certificat C :\Test\MySign.pfx dans la variable $cert.
La deuxième commande utilise Set-AuthenticodeSignature pour signer le script. Le paramètre FilePath de Set-AuthenticodeSignature spécifie le chemin d’accès au fichier de script signé et le paramètre Cert transmet la variable $cert contenant le certificat à Set-AuthenticodeSignature.
Si le fichier de certificat est protégé par mot de passe, PowerShell vous invite à entrer le mot de passe.
Exemple 3 : Ajouter une signature qui inclut l’autorité racine
Cette commande ajoute une signature numérique qui inclut l’autorité racine dans la chaîne d’approbation, et elle est signée par un serveur d’horodatage tiers.
Set-AuthenticodeSignature -FilePath c:\scripts\Remodel.ps1 -Certificate $cert -IncludeChain All -TimestampServer "http://timestamp.fabrikam.com/scripts/timstamper.dll"La commande utilise le paramètre FilePath
Paramètres
-Certificate
Spécifie le certificat qui sera utilisé pour signer le script ou le fichier. Entrez une variable qui stocke un objet représentant le certificat ou une expression qui obtient le certificat.
Pour rechercher un certificat, utilisez Get-PfxCertificate ou utilisez l’applet de commande Get-ChildItem dans le lecteur de Cert: certificat. Si le certificat n’est pas valide ou n’a pas d’autorité code-signing, la commande échoue.
| Type: | X509Certificate2 |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Content
Ce paramètre apparaît dans la liste de syntaxes, car il est défini dans la classe de base à partir de laquelle Set-AuthenticodeSignature est dérivée. Toutefois, la prise en charge de ce paramètre n’est pas implémentée dans Set-AuthenticodeSignature.
| Type: | Byte[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-FilePath
Spécifie le chemin d’accès à un fichier en cours de signature.
| Type: | String[] |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Force
Permet à l’applet de commande d’ajouter une signature à un fichier en lecture seule. Même à l’aide du paramètre Forcer, l’applet de commande ne peut pas remplacer les restrictions de sécurité.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-HashAlgorithm
Spécifie l’algorithme de hachage utilisé par Windows pour calculer la signature numérique du fichier.
Pour PowerShell 3.0, la valeur par défaut est SHA256, qui est l’algorithme de hachage windows par défaut. Pour PowerShell 2.0, la valeur par défaut est SHA1. Les fichiers signés avec un autre algorithme de hachage peuvent ne pas être reconnus sur d’autres systèmes. Les algorithmes pris en charge dépendent de la version du système d’exploitation.
Pour obtenir la liste des valeurs possibles, consultez hashAlgorithmName Struct.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | SHA256 |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-IncludeChain
Détermine les certificats de la chaîne d’approbation de certificats inclus dans la signature numérique. NotRoot est la valeur par défaut.
Les valeurs valides sont les suivantes :
- Signataire : inclut uniquement le certificat du signataire.
- NotRoot : inclut tous les certificats de la chaîne de certificats, à l’exception de l’autorité racine.
- Tout : inclut tous les certificats de la chaîne de certificats.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | NotRoot |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-LiteralPath
Spécifie le chemin d’accès à un fichier en cours de signature. Contrairement à FilePath, la valeur du paramètre LiteralPath est utilisée exactement comme il est typé. Aucun caractère n’est interprété comme des caractères génériques. Si le chemin inclut des caractères d’échappement, placez-le entre 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 |
-SourcePathOrExtension
Ce paramètre apparaît dans la liste de syntaxes, car il est défini dans la classe de base à partir de laquelle Set-AuthenticodeSignature est dérivée. Toutefois, la prise en charge de ce paramètre n’est pas implémentée dans Set-AuthenticodeSignature.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-TimestampServer
Utilise le serveur d’horodatage spécifié pour ajouter un horodatage à la signature. Tapez l’URL du serveur d’horodatage sous forme de chaîne.
L’horodatage représente l’heure exacte à laquelle le certificat a été ajouté au fichier. Un horodatage empêche l’échec du script si le certificat expire, car les utilisateurs et les programmes peuvent vérifier que le certificat était valide au moment de la signature.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Vous pouvez diriger une chaîne qui contient le chemin d’accès du fichier à Set-AuthenticodeSignature.
Sorties
Notes
Cette applet de commande est disponible uniquement sur les plateformes Windows.