Unblock-File

Başvuru

Modül:: Microsoft.PowerShell.Utility

İnternet'ten indirilen dosyaların engellemesini kaldırır.

Sözdizimi

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

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

Description

Bu cmdlet yalnızca Windows ve macOS platformlarında çalışır.

Unblock-File cmdlet'i, internetten indirilen dosyaları açmanıza olanak tanır. PowerShell yürütme ilkesi RemoteSigned bile çalıştırabilmeniz için internetten indirilen PowerShell betik dosyalarının engelini kaldırır. Varsayılan olarak, bilgisayarı güvenilmeyen dosyalardan korumak için bu dosyalar engellenir.

Unblock-File cmdlet'ini kullanmadan önce dosyayı ve kaynağını gözden geçirin ve güvenli bir şekilde açıldığını doğrulayın.

dahili olarak, Unblock-File cmdlet'i Zone.Identifier alternatif veri akışını kaldırır ve bu, İnternet'ten indirildiğini göstermek için 3 değerine sahiptir.

PowerShell yürütme ilkeleri hakkında daha fazla bilgi için bkz. about_Execution_Policies.

Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.

Örnekler

Örnek 1: Dosyanın engelini kaldırma

Bu komut PowerShellTips.chm dosyasının engelini kaldırır.

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

Örnek 2: Birden çok dosya engellemesini kaldırma

Bu komut, adları "PowerShell" olan C:\Downloads dizinindeki tüm dosyaların engelini kaldırır. Tüm dosyaların güvenli olduğunu doğrulayana kadar bunun gibi bir komut çalıştırmayın.

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

Örnek 3: Betikleri bulma ve engellemesini kaldırma

Bu komut, PowerShell betiklerini bulma ve engellemeyi kaldırmayı gösterir.

İlk komut, Zone.Identifier akışına sahip Get-Item cmdlet'i get dosyalarının Stream parametresini kullanır.

İkinci komut, yürütme ilkesinin RemoteSigned bir PowerShell oturumunda engellenen bir betik çalıştırdığınızda ne olacağını gösterir. RemoteSigned ilkesi, dijital olarak imzalanmadıkları sürece internetten indirilen betikleri çalıştırmanızı engeller.

Üçüncü komut, Unblock-File cmdlet'ini kullanarak betiğin engelini kaldırır ve böylece oturumda çalışabilir.

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

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-LiteralPath

Engeli kaldıracak dosyaları belirtir. Pathaksine, LiteralPath parametresinin değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın ('). Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Tür:	String[]
Diğer adlar:	PSPath, LP
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Path

Engeli kaldıracak dosyaları belirtir. Joker karakterler desteklenir.

Tür:	String[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

String

Bir dosya yolunu bu cmdlet'e aktarabilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

PowerShell 7'de macOS desteği eklendi.
Unblock-File cmdlet'i yalnızca dosya sistemi sürücülerinde çalışır.
Unblock-File, Dosya Gezgini'ndeki Özellikler iletişim kutusundaki Engelini Kaldır düğmesiyle aynı işlemi gerçekleştirir.
engellenmeyen bir dosyada Unblock-File cmdlet'ini kullanırsanız, komutun engellenmemiş dosya üzerinde hiçbir etkisi olmaz ve cmdlet hata oluşturmaz.