Unblock-File

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

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

構文

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

説明

このコマンドレットは、Windows および macOS プラットフォームでのみ機能します。

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

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

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

-LiteralPath

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

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

-Path

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

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

-WhatIf

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

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

入力

String

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

出力

None

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

メモ

  • PowerShell 7 で macOS のサポートが追加されました。
  • コマンドレットは Unblock-File 、ファイル システム ドライブでのみ機能します。
  • Unblock-Fileは、エクスプローラーの [プロパティ] ダイアログ ボックスの [ブロック解除] ボタンと同じ操作を実行します。
  • ブロックされていないファイルで コマンドレットを Unblock-File 使用した場合、コマンドはブロック解除されたファイルに影響を及ぼすことはありません。また、コマンドレットはエラーを生成しません。