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>]

El cmdlet Set-AuthenticodeSignature 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.

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 cmdlet Get-ChildItem y el proveedor de certificados de PowerShell para obtener los certificados en el subdirectorio Cert:\CurrentUser\My del almacén de certificados. La unidad Cert: 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 variable $cert.

El segundo comando define la variable $signingParameters como hashTable con los parámetros del cmdlet Set-AuthenticodeSignature para firmar el script de PSTestInternet2.ps1. Usa el parámetro FilePath para especificar el nombre del script, el parámetro Certificate para especificar que el certificado se almacena en la variable $cert 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.

Estos comandos usan el cmdlet Get-PfxCertificate 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 cmdlet Get-PfxCertificate para cargar el certificado C:\Test\MySign.pfx en la variable $cert.

El segundo comando define la variable $signingParameters como hashTable con los parámetros del cmdlet Set-AuthenticodeSignature para firmar el script de ServerProps.ps1. Usa el parámetro FilePath para especificar el nombre del script, el parámetro Certificate para especificar que el certificado se almacena en la variable $cert 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.

Este comando agrega una firma digital que incluye la entidad raíz en la cadena de confianza y está firmada 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 comando usa el parámetro FilePath para especificar el script que se firma y el parámetro Certificate para especificar el certificado que se guarda en la variable $cert. 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 impide que se produzca un error en el script cuando expire el certificado.

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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

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