Set-AuthenticodeSignature

Set-AuthenticodeSignature
    [-Certificate] <X509Certificate2>
    [-FilePath] <String[]>
    [-IncludeChain <String>]
    [-TimestampServer <String>]
    [-HashAlgorithm <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-AuthenticodeSignature
    [-Certificate] <X509Certificate2>
    -LiteralPath <String[]>
    [-IncludeChain <String>]
    [-TimestampServer <String>]
    [-HashAlgorithm <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-AuthenticodeSignature
    [-Certificate] <X509Certificate2>
    -SourcePathOrExtension <String[]>
    -Content <Byte[]>
    [-IncludeChain <String>]
    [-TimestampServer <String>]
    [-HashAlgorithm <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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.

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 $cert

La 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.

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 $cert

La 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.

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.

$signingParameters = @{
    FilePath      = 'C:\scripts\Remodel.ps1'
    Certificate   = $cert
    HashAlgorithm = 'SHA256'
    IncludeChain  = 'All'
    TimestampServer = 'http://timestamp.fabrikam.com/scripts/timstamper.dll'
}
Set-AuthenticodeSignature @signingParameters

La commande utilise le paramètre FilePath pour spécifier le script signé et le paramètre Certificate pour spécifier le certificat enregistré dans la variable $cert. Il utilise le paramètre IncludeChain pour inclure toutes les signatures de la chaîne de confiance, y compris l’autorité racine. Il utilise également le paramètre TimeStampServer pour ajouter un horodatage à la signature. Cela empêche l’échec du script lors de l’expiration du certificat.

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.

Vous pouvez transmettre une chaîne qui contient le chemin d'accès du fichier à cette cmdlet.

Ce cmdlet retourne un objet Signature qui représente la valeur qu'il a définie.

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