Set-AuthenticodeSignature

モジュール:

Microsoft.PowerShell.Security

PowerShell スクリプトまたはその他の ファイルに Authenticode 署名を追加します。

構文

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

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

コマンドレットは Set-AuthenticodeSignature 、サブジェクト インターフェイス パッケージ (SIP) をサポートするすべてのファイルに Authenticode 署名を追加します。

PowerShell スクリプト ファイルでは、署名は、スクリプトで実行される命令の末尾を示すテキスト ブロックの形式になります。 このコマンドレットが実行されるときにファイル内に署名がある場合、その署名は削除されます。

例

例 1 - ローカル証明書ストアの証明書を使用してスクリプトに署名する

これらのコマンドは、PowerShell 証明書プロバイダーからコード署名証明書を取得し、それを使用して PowerShell スクリプトに署名します。

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

最初のコマンドでは、 Get-ChildItem コマンドレットと PowerShell 証明書プロバイダーを使用して、証明書ストアのサブディレクトリにある Cert:\CurrentUser\My 証明書を取得します。 ドライブは Cert: 、証明書プロバイダーによって公開されるドライブです。 CodeSigningCert パラメーターは、証明書プロバイダーによってのみサポートされ、取得される証明書をコード署名機関を持つ証明書に制限します。 このコマンドは、結果を変数に $cert 格納します。

2 番目のコマンドでは、コマンドレットを Set-AuthenticodeSignature 使用してスクリプトに PSTestInternet2.ps1 署名します。 FilePath パラメーターを使用してスクリプトの名前を指定し、Certificate パラメーターを使用して証明書が変数に$cert格納されることを指定します。

Note

CodeSigningCert パラメーターGet-ChildItemを使用すると、コード署名機関を持ち、秘密キーを含む証明書のみが返されます。 秘密キーがない場合は、署名に証明書を使用できません。

例 2 - PFX ファイルの証明書を使用してスクリプトに署名する

これらのコマンドでは、コマンドレットを Get-PfxCertificate 使用してコード署名証明書を読み込みます。 次に、それを使用して PowerShell スクリプトに署名します。

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

最初のコマンドでは、コマンドレットを Get-PfxCertificate 使用して C:\Test\MySign.pfx 証明書を変数に $cert 読み込みます。

2 番目のコマンドは、スクリプトの署名に使用 Set-AuthenticodeSignature します。 FilePath パラメーターは、署名するスクリプト ファイルへのパスを指定し、Cert パラメーターは証明書Set-AuthenticodeSignatureを$cert含む変数を渡します。Set-AuthenticodeSignature

証明書ファイルがパスワードで保護されている場合、PowerShell によってパスワードの入力が求められます。

例 3 - ルート機関を含む署名を追加する

このコマンドは、信頼チェーンのルート証明機関を含むデジタル署名を追加します。これは、サードパーティのタイムスタンプ サーバーにより署名されます。

Set-AuthenticodeSignature -FilePath c:\scripts\Remodel.ps1 -Certificate $cert -IncludeChain All -TimestampServer "https://timestamp.fabrikam.com/scripts/timstamper.dll"

このコマンドでは、FilePath パラメーターを使用して署名するスクリプトを指定し、Certificate パラメーターを使用して変数に保存される証明書を$cert指定します。 IncludeChain パラメーターを使用して、ルート機関を含め、信頼チェーン内のすべての署名を含めます。 また、TimeStampServer パラメーターを使用して、署名にタイムスタンプを追加します。 これにより、証明の有効期限が切れた場合にもスクリプトは失敗しません。

パラメーター

-Certificate

スクリプトまたはファイルへの署名に使用する証明書を指定します。 証明書を表すオブジェクトを格納する変数、または証明書を取得する式を入力します。

証明書を検索するには、証明書Cert:ドライブでコマンドレットをGet-ChildItem使用Get-PfxCertificateまたは使用します。 証明書が有効でない場合、または権限がない code-signing 場合、コマンドは失敗します。

Type:	X509Certificate2
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Content

このパラメーターは、派生元の基底クラス Set-AuthenticodeSignature で定義されているため、構文リストに表示されます。 ただし、このパラメーターのサポートは Set-AuthenticodeSignature.

Type:	Byte[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-FilePath

署名するファイルへのパスを指定します。

Type:	String[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

コマンドレットで読み取り専用ファイルに署名を追加できるようにします。 Force パラメーターを使用しても、コマンドレットはセキュリティ制限をオーバーライドできません。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HashAlgorithm

Windows でファイルのデジタル署名の計算に使用されるハッシュ アルゴリズムを指定します。

PowerShell 7.3 の場合、既定値は SHA256 で、これは Windows の既定のハッシュ アルゴリズムです。 以前のバージョンの場合、既定値は SHA1 です。 異なるハッシュ アルゴリズムで署名されたファイルは、他のシステムで認識されない可能性があります。 サポートされているアルゴリズムは、オペレーティング システムのバージョンによって異なります。

使用可能な値の一覧については、「HashAlgorithmName 構造体」を参照してください。

Type:	String
Position:	Named
Default value:	SHA256
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeChain

証明書の信頼チェーン内のどの証明書がデジタル署名に含まれているかを判断します。 NotRoot が既定値です。

有効な値は次の通りです。

• 署名者: 署名者の証明書のみが含まれます。
• NotRoot: ルート証明機関を除き、証明書チェーン内のすべての証明書が含まれます。
• すべて: 証明書チェーン内のすべての証明書が含まれます。

Type:	String
Position:	Named
Default value:	NotRoot
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LiteralPath

署名するファイルへのパスを指定します。 FilePath とは異なり、LiteralPath パラメーターの値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。

Type:	String[]
Aliases:	PSPath
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SourcePathOrExtension

このパラメーターは、派生元の基底クラス Set-AuthenticodeSignature で定義されているため、構文リストに表示されます。 ただし、このパラメーターのサポートは Set-AuthenticodeSignature.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TimestampServer

指定されたタイム スタンプ サーバーを使用して、署名にタイム スタンプを追加します。 タイム スタンプ サーバーの URL を文字列として入力します。 URL の先頭 https:// は 〗または http://〘 にする必要があります。

タイム スタンプは、証明書がファイルに追加された正確な時間を表します。 タイム スタンプを使用すると、署名時に証明書が有効だったことをユーザーとプログラムで検証できるため、証明書の期限が過ぎている場合であってもスクリプトは失敗しません。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

String

このコマンドレットへのファイル パスを含む文字列をパイプ処理できます。

出力

Signature

このコマンドレットは、設定した値を 表す Signature オブジェクトを返します。

メモ

このコマンドレットは、Windows プラットフォームでのみ使用できます。

関連リンク

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