Aracılığıyla paylaş

Unblock-File

Modül:
Microsoft.PowerShell.Utility Module

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

Syntax

ByPath (Varsayılan) 

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

ByLiteralPath 

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.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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, onu tek tırnak içine alın ('). Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:PSPath, LP

Parametre kümeleri

ByLiteralPath
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Path

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

ByPath
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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.