Set-AuthenticodeSignature

Sintaxis

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

El Set-AuthenticodeSignature cmdlet agrega una firma Authenticode a cualquier archivo que admita Subject Interface Package (SIP).

En un archivo de script de PowerShell, la firma adopta la forma de un bloque de texto que indica el final de las instrucciones que se ejecutan en el script. Si hay una firma en el archivo cuando se ejecuta este cmdlet, se quita esa firma.

Ejemplos

Ejemplo 1: Firmar un script mediante un certificado del almacén de certificados local

Estos comandos recuperan un certificado de firma de código del proveedor de certificados de PowerShell y lo usan para firmar un script de PowerShell.

$cert=Get-ChildItem -Path Cert:\CurrentUser\My -CodeSigningCert
$signingParameters = @{
    FilePath      = 'PsTestInternet2.ps1'
    Certificate   = $cert
    HashAlgorithm = 'SHA256'
}
Set-AuthenticodeSignature @signingParameters

El primer comando usa el Get-ChildItem cmdlet y el proveedor de certificados de PowerShell para obtener los certificados en el Cert:\CurrentUser\My subdirectorio del almacén de certificados. La Cert: unidad es la unidad expuesta por el proveedor de certificados. El parámetro CodeSigningCert , que solo es compatible con el proveedor de certificados, limita los certificados recuperados a los que tienen entidad de firma de código. El comando almacena el resultado en la $cert variable .

El segundo comando define la $signingParameters variable como hashTable con los parámetros del Set-AuthenticodeSignature cmdlet para firmar el PSTestInternet2.ps1 script. Usa el parámetro FilePath para especificar el nombre del script, el parámetro Certificate para especificar que el certificado se almacena en la $cert variable y el parámetro HashAlgorithm para establecer el algoritmo hash en SHA256.

El tercer comando firma el script mediante la expansión de los parámetros definidos en $signingParameters.

Ejemplo 2: Firmar un script mediante un certificado de un archivo PFX

Estos comandos usan el Get-PfxCertificate cmdlet para cargar un certificado de firma de código. A continuación, úselo para firmar un script de PowerShell.

$cert = Get-PfxCertificate -FilePath C:\Test\Mysign.pfx
$signingParameters = @{
    FilePath      = 'ServerProps.ps1'
    Certificate   = $cert
    HashAlgorithm = 'SHA256'
}
Set-AuthenticodeSignature @signingParameters

El primer comando usa el Get-PfxCertificate cmdlet para cargar el certificado C:\Test\MySign.pfx en la $cert variable.

El segundo comando define la $signingParameters variable como hashTable con los parámetros del Set-AuthenticodeSignature cmdlet para firmar el ServerProps.ps1 script. Usa el parámetro FilePath para especificar el nombre del script, el parámetro Certificate para especificar que el certificado se almacena en la $cert variable y el parámetro HashAlgorithm para establecer el algoritmo hash en SHA256.

El tercer comando firma el script mediante la expansión de los parámetros definidos en $signingParameters.

Si el archivo de certificado está protegido con contraseña, PowerShell le pedirá la contraseña.

Ejemplo 3: Agregar una firma que incluya la entidad raíz

Este comando agrega una firma digital que incluye la entidad de certificación raíz en la cadena de confianza y está firmado por un servidor de marca de tiempo de terceros.

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

El primer comando define la $signingParameters variable como hashTable con los parámetros del Set-AuthenticodeSignature cmdlet para firmar el script. Usa el parámetro FilePath para especificar la ruta de acceso al script, el parámetro Certificate para especificar que el certificado se almacena en la $cert variable y el parámetro HashAlgorithm para establecer el algoritmo hash en SHA256. Usa el parámetro IncludeChain para incluir todas las firmas de la cadena de confianza, incluida la entidad raíz. También usa el parámetro TimeStampServer para agregar una marca de tiempo a la firma. Esto evita que el script genere un error cuando el certificado expira.

El segundo comando firma el script mediante la expansión de los parámetros definidos en $signingParameters.

Parámetros

-Certificate

-Confirm

-Content

-FilePath

-Force

-HashAlgorithm

-IncludeChain

-LiteralPath

-SourcePathOrExtension

-TimestampServer

-WhatIf

Entradas

String

Puede canalizar una cadena que contenga la ruta de acceso del archivo a este cmdlet.

Salidas

Signature

Este cmdlet devuelve un objeto Signature que representa el valor establecido.

Vínculos relacionados

• Get-AuthenticodeSignature
• Get-ExecutionPolicy
• Get-PfxCertificate
• Set-ExecutionPolicy
• about_Execution_Policies
• about_Signing