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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De cmdlet Set-AuthenticodeSignature voegt een Authenticode-handtekening toe aan elk bestand dat SIP (Subject Interface Package) ondersteunt.

In een PowerShell-scriptbestand heeft de handtekening de vorm van een tekstblok dat het einde aangeeft van de instructies die in het script worden uitgevoerd. Als er een handtekening in het bestand staat wanneer deze cmdlet wordt uitgevoerd, wordt die handtekening verwijderd.

Met deze opdrachten haalt u een certificaat voor ondertekening van programmacode op bij de PowerShell-certificaatprovider en gebruikt u dit om een PowerShell-script te ondertekenen.

$cert = Get-ChildItem -Path Cert:\CurrentUser\My -CodeSigningCert
Set-AuthenticodeSignature -FilePath PsTestInternet2.ps1 -Certificate $cert

De eerste opdracht maakt gebruik van de Get-ChildItem-cmdlet en de PowerShell-certificaatprovider om de certificaten op te halen in de submap Cert:\CurrentUser\My van het certificaatarchief. Het Cert: station is het station dat door de certificaatprovider wordt weergegeven. De parameter CodeSigningCert, die alleen wordt ondersteund door de certificaatprovider, beperkt de certificaten die zijn opgehaald aan certificaten met een instantie voor ondertekening van programmacode. Met de opdracht wordt het resultaat opgeslagen in de $cert variabele.

De tweede opdracht maakt gebruik van de Set-AuthenticodeSignature cmdlet om het PSTestInternet2.ps1 script te ondertekenen. Hierbij wordt de parameter FilePath gebruikt om de naam van het script en de parameter Certificate op te geven om op te geven dat het certificaat is opgeslagen in de variabele $cert.

Deze opdrachten gebruiken de Get-PfxCertificate cmdlet om een certificaat voor ondertekening van code te laden. Gebruik dit vervolgens om een PowerShell-script te ondertekenen.

$cert = Get-PfxCertificate -FilePath C:\Test\Mysign.pfx
Set-AuthenticodeSignature -FilePath ServerProps.ps1 -Certificate $cert

De eerste opdracht gebruikt de Get-PfxCertificate cmdlet om het C:\Test\MySign.pfx certificaat in de $cert variabele te laden.

De tweede opdracht gebruikt Set-AuthenticodeSignature om het script te ondertekenen. De parameter FilePath van Set-AuthenticodeSignature geeft het pad op naar het scriptbestand dat wordt ondertekend en de parameter certificaat geeft de $cert variabele met het certificaat door aan Set-AuthenticodeSignature.

Als het certificaatbestand met een wachtwoord is beveiligd, wordt u door PowerShell gevraagd om het wachtwoord.

Met deze opdracht wordt een digitale handtekening toegevoegd die de hoofdinstantie in de vertrouwensketen bevat en die is ondertekend door een tijdstempelserver van derden.

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

De opdracht gebruikt de parameter FilePath om het script op te geven dat wordt ondertekend en de parameter Certificate om het certificaat op te geven dat is opgeslagen in de $cert variabele. Hierbij wordt de parameter IncludeChain gebruikt om alle handtekeningen in de vertrouwensketen op te nemen, inclusief de basisinstantie. Ook wordt de parameter TimeStampServer gebruikt om een tijdstempel toe te voegen aan de handtekening. Dit voorkomt dat het script mislukt wanneer het certificaat verloopt.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks dat het bestandspad bevat naar deze cmdlet doorgeven.

Deze cmdlet retourneert een Signature object dat de waarde vertegenwoordigt die is ingesteld.

Deze cmdlet is alleen beschikbaar op Windows-platforms.