Unblock-File

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

インターネットからダウンロードされたファイルのブロックを解除します。

構文

Unblock-File
       [-Path] <String[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Unblock-File
       -LiteralPath <String[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

Unblock-File コマンドレットを使用すると、インターネットからダウンロードしたファイルを開くことができます。 インターネットからダウンロードされた PowerShell スクリプト ファイルのブロックが解除されるため、PowerShell 実行ポリシーが RemoteSigned場合でも実行できます。 既定では、信頼されていないファイルからコンピューターを保護するために、これらのファイルはブロックされています。

Unblock-File コマンドレットを使用する前に、ファイルとそのソースを確認し、安全に開くことができることを確認します。

内部的には、 Unblock-File コマンドレットは、 Zone.Identifier 代替データ ストリームを削除します。代替データ ストリームは、インターネットからダウンロードされたことを示す値が 3 です。

PowerShell 実行ポリシーの詳細については、「 about_Execution_Policies」を参照してください。

このコマンドレットは、Windows PowerShell 3.0 で導入されました。

例

例 1: ファイルのブロックを解除する

このコマンドは、 PowerShellTips.chm ファイルのブロックを解除します。

PS C:\> Unblock-File -Path C:\Users\User01\Documents\Downloads\PowerShellTips.chm

例 2: 複数のファイルのブロックを解除する

このコマンドは、名前に "PowerShell" が含まれる C:\Downloads ディレクトリ内のすべてのファイルのブロックを解除します。 すべてのファイルが安全なことを確認してから、コマンドを実行してください。

PS C:\> dir C:\Downloads\*PowerShell* | Unblock-File

例 3: スクリプトの検索とブロック解除

このコマンドは、PowerShell スクリプトを見つけてブロックを解除する方法を示します。

最初のコマンドでは、Get-Item コマンドレットの Stream パラメーターを使用して、Zone.Identifier ストリームを持つファイルを取得します。

2 番目のコマンドは、実行ポリシーが RemoteSigned である PowerShell セッションでブロックされたスクリプトを実行した場合の動作を示しています。 RemoteSigned ポリシーを使用すると、デジタル署名されていない限り、インターネットからダウンロードされたスクリプトを実行できなくなります。

3 番目のコマンドでは、 Unblock-File コマンドレットを使用してスクリプトのブロックを解除し、セッションで実行できるようにします。

PS C:\> Get-Item * -Stream "Zone.Identifier" -ErrorAction SilentlyContinue
   FileName: C:\ps-test\Start-ActivityTracker.ps1

Stream                   Length
------                   ------
Zone.Identifier              26

PS C:\> C:\ps-test\Start-ActivityTracker.ps1
c:\ps-test\Start-ActivityTracker.ps1 : File c:\ps-test\Start-ActivityTracker.ps1 cannot
be loaded. The file c:\ps-test\Start-ActivityTracker.ps1 is not digitally signed. The script
will not execute on the system. For more information, see about_Execution_Policies.

At line:1 char:1
+ c:\ps-test\Start-ActivityTracker.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

PS C:\> Get-Item C:\ps-test\Start-ActivityTracker.ps1 | Unblock-File

パラメーター

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LiteralPath

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

型:String[]
Aliases:PSPath, LP
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Path

ブロックを解除するファイルを指定します。 ワイルドカード文字がサポートされています。

型:String[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

このコマンドレットにファイル パスをパイプできます。

出力

None

このコマンドレットは、出力を返しません。

メモ

  • Unblock-File コマンドレットは、ファイル システム ドライブでのみ機能します。
  • Unblock-Fileは、エクスプローラーの Properties ダイアログ ボックスの Unblock ボタンと同じ操作を実行します。
  • ブロックされていないファイルで Unblock-File コマンドレットを使用する場合、コマンドはブロック解除されたファイルに影響を与えません。また、コマンドレットはエラーを生成しません。