Unblock-File

Referencia

Modul:: Microsoft.PowerShell.Utility

Feloldja az internetről letöltött fájlok letiltását.

Syntax

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

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

Description

Ez a parancsmag csak Windows és macOS platformokon működik.

A Unblock-File parancsmaggal megnyithatja az internetről letöltött fájlokat. Feloldja az internetről letöltött PowerShell-szkriptfájlok letiltását, így futtathatja őket, még akkor is, ha a PowerShell végrehajtási szabályzata RemoteSigned. Alapértelmezés szerint ezek a fájlok le vannak tiltva, hogy megvédjék a számítógépet a nem megbízható fájloktól.

A Unblock-File parancsmag használata előtt tekintse át a fájlt és annak forrását, és ellenőrizze, hogy biztonságos-e a megnyitás.

A Unblock-File parancsmag belsőleg eltávolítja a Zone.Identifier alternatív adatfolyamot, amelynek értéke 3 annak jelzése, hogy az internetről lett letöltve.

További információ a PowerShell végrehajtási szabályzatairól: about_Execution_Policies.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: Fájl tiltásának feloldása

Ez a parancs feloldja a PowerShellTips.chm fájl blokkolását.

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

2. példa: Több fájl blokkolásának feloldása

Ez a parancs feloldja a C:\Downloads könyvtárban lévő összes fájlt, amelynek a neve tartalmazza a "PowerShellt". Ne futtasson ehhez hasonló parancsot, amíg nem ellenőrizte, hogy az összes fájl biztonságos-e.

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

3. példa: Szkriptek keresése és letiltása

Ez a parancs bemutatja, hogyan keresheti meg és oldhatja fel a PowerShell-szkriptek letiltását.

Az első parancs a Get-Item parancsmag Stream paraméterét használja a Zone.Identifier streamet tartalmazó fájlok lekéréséhez.

A második parancs bemutatja, mi történik, ha blokkolt szkriptet futtat egy PowerShell-munkamenetben, amelyben a végrehajtási szabályzat RemoteSigned. A RemoteSigned házirend megakadályozza az internetről letöltött szkriptek futtatását, kivéve, ha azok digitálisan aláírtak.

A harmadik parancs a Unblock-File parancsmaggal oldja fel a szkript letiltását, hogy az a munkamenetben fusson.

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

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-LiteralPath

Megadja a letiltani kívánt fájlokat. A Path-tal ellentétben a LiteralPath paraméter értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz feloldó karaktereket, csatolja egy idézőjelbe ('). Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

Típus:	String[]
Aliasok:	PSPath, LP
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Path

Megadja a letiltani kívánt fájlokat. A helyettesítő karakterek támogatottak.

Típus:	String[]
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	True

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

String

Ehhez a parancsmaghoz egy fájl elérési útját is be lehet csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

A macOS támogatása a PowerShell 7-ben lett hozzáadva.
A Unblock-File parancsmag csak fájlrendszer-meghajtókon működik.
Unblock-File ugyanazt a műveletet hajtja végre, mint a Tiltás feloldása gomb a Fájlkezelő Tulajdonságok párbeszédpanelén.
Ha a Unblock-File parancsmagot nem blokkolt fájlon használja, a parancsnak nincs hatása a feloldott fájlra, és a parancsmag nem okoz hibákat.