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

Polecenie cmdlet Set-AuthenticodeSignature dodaje podpis Authenticode do każdego pliku, który obsługuje Pakiet Interfejsu Podmiotu (SIP).

W pliku skryptu programu PowerShell podpis ma postać bloku tekstu, który wskazuje koniec instrukcji wykonywanych w skry skryfcie. Jeśli plik zawiera podpis po uruchomieniu tego polecenia cmdlet, ten podpis zostanie usunięty.

Te polecenia pobierają certyfikat podpisywania kodu od dostawcy certyfikatów programu PowerShell i używają go do podpisywania skryptu programu PowerShell.

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

Pierwsze polecenie używa polecenia cmdlet Get-ChildItem i dostawcy certyfikatów programu PowerShell do pobrania certyfikatów w podkatalogu Cert:\CurrentUser\My magazynu certyfikatów. Dysk Cert: jest dyskiem udostępnianym przez dostawcę certyfikatów. Parametr CodeSigningCert, który jest obsługiwany tylko przez dostawcę certyfikatów, ogranicza certyfikaty pobrane do tych z urzędem podpisywania kodu. Polecenie przechowuje wynik w zmiennej $cert.

Drugie polecenie definiuje zmienną $signingParameters jako HashTable z parametrami polecenia cmdlet Set-AuthenticodeSignature w celu podpisania skryptu PSTestInternet2.ps1. Używa parametru FilePath, aby określić nazwę skryptu, parametr certyfikatu, aby określić, że certyfikat jest przechowywany w zmiennej $cert, a parametr HashAlgorithm ustawić algorytm wyznaczania wartości skrótu na SHA256.

Trzecie polecenie podpisuje skrypt przez przeplatanie parametrów zdefiniowanych w $signingParameters.

Te polecenia używają polecenia cmdlet Get-PfxCertificate do załadowania certyfikatu podpisywania kodu. Następnie użyj go do podpisania skryptu programu PowerShell.

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

Pierwsze polecenie używa polecenia cmdlet Get-PfxCertificate do załadowania certyfikatu C:\Test\MySign.pfx do zmiennej $cert.

Drugie polecenie definiuje zmienną $signingParameters jako HashTable z parametrami polecenia cmdlet Set-AuthenticodeSignature w celu podpisania skryptu ServerProps.ps1. Używa parametru FilePath, aby określić nazwę skryptu, parametr certyfikatu, aby określić, że certyfikat jest przechowywany w zmiennej $cert, a parametr HashAlgorithm ustawić algorytm wyznaczania wartości skrótu na SHA256.

Trzecie polecenie podpisuje skrypt przez przeplatanie parametrów zdefiniowanych w $signingParameters.

Jeśli plik certyfikatu jest chroniony hasłem, program PowerShell wyświetli monit o podanie hasła.

To polecenie dodaje podpis cyfrowy, który zawiera urząd główny w łańcuchu zaufania i jest podpisany przez serwer sygnatury czasowej innej firmy.

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

Polecenie używa parametru FilePath w celu określenia podpisanego skryptu oraz parametru Certificate w celu określenia certyfikatu zapisanego w zmiennej $cert. Używa on parametru IncludeChain, aby uwzględnić wszystkie podpisy w łańcuchu zaufania, w tym urząd główny. Używa również parametru TimeStampServer, aby dodać znacznik czasu do podpisu. Zapobiega to awarii skryptu po wygaśnięciu certyfikatu.

Drugie polecenie podpisuje skrypt przez przeplatanie parametrów zdefiniowanych w $signingParameters.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Możesz przesłać strumieniowo ciąg znaków zawierający ścieżkę pliku do tego cmdletu.

To polecenie cmdlet zwraca obiekt Signature reprezentujący ustawioną wartość.