Bagikan melalui

Unblock-File

Modul:
Microsoft.PowerShell.Utility Module

Membuka blokir file yang diunduh dari internet.

Sintaks

ByPath (Default) 

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

ByLiteralPath 

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

Deskripsi

Cmdlet ini hanya berfungsi pada platform Windows dan macOS.

Cmdlet Unblock-File memungkinkan Anda membuka file yang diunduh dari internet. Ini membuka blokir file skrip PowerShell yang diunduh dari internet sehingga Anda dapat menjalankannya, bahkan ketika kebijakan eksekusi PowerShell RemoteSigned. Secara default, file-file ini diblokir untuk melindungi komputer dari file yang tidak tepercaya.

Sebelum menggunakan cmdlet Unblock-File, tinjau file dan sumbernya dan verifikasi bahwa aman untuk dibuka.

Secara internal, cmdlet Unblock-File menghapus Zone.Identifier aliran data alternatif, yang memiliki nilai 3 untuk menunjukkan bahwa itu diunduh dari internet.

Untuk informasi selengkapnya tentang kebijakan eksekusi PowerShell, lihat about_Execution_Policies.

Cmdlet ini diperkenalkan di Windows PowerShell 3.0.

Contoh

Contoh 1: Membuka blokir file

Perintah ini membuka blokir file PowerShellTips.chm.

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

Contoh 2: Membuka blokir beberapa file

Perintah ini membuka blokir semua file di direktori C:\Downloads yang namanya menyertakan "PowerShell". Jangan jalankan perintah seperti ini sampai Anda telah memverifikasi bahwa semua file aman.

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

Contoh 3: Menemukan dan membuka blokir skrip

Perintah ini memperlihatkan cara menemukan dan membuka blokir skrip PowerShell.

Perintah pertama menggunakan parameter Stream dari cmdlet Get-Item mendapatkan file dengan Zone.Identifier stream.

Perintah kedua menunjukkan apa yang terjadi saat Anda menjalankan skrip yang diblokir dalam sesi PowerShell di mana kebijakan eksekusi RemoteSigned. Kebijakan RemoteSigned mencegah Anda menjalankan skrip yang diunduh dari internet kecuali ditandatangani secara digital.

Perintah ketiga menggunakan cmdlet Unblock-File untuk membuka blokir skrip sehingga dapat berjalan dalam sesi.

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

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-LiteralPath

Menentukan berkas yang akan diblokir. Tidak seperti Jalur, nilai parameter LiteralPath digunakan persis sebagaimana diketik. Tidak ada karakter yang ditafsirkan sebagai wildcard. Jika jalur menyertakan karakter escape, letakkan dalam tanda kutip tunggal ('). Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:PSPath, LP

Kumpulan parameter

ByLiteralPath
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Path

Menentukan berkas yang akan diblokir. Karakter kartubebas didukung.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

ByPath
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

Anda dapat menyalurkan jalur file ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

  • Dukungan untuk macOS ditambahkan di PowerShell 7.
  • Cmdlet Unblock-File hanya berfungsi di drive sistem file.
  • Unblock-File melakukan operasi yang sama dengan tombol Buka Blokir pada kotak dialog Properti di File Explorer.
  • Jika Anda menggunakan cmdlet Unblock-File pada file yang tidak diblokir, perintah tidak berpengaruh pada file yang tidak diblokir dan cmdlet tidak menghasilkan kesalahan.