Unblock-File
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, hogy futtathassa ő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 parancsmag használata Unblock-File
előtt tekintse át a fájlt és annak forrását, és ellenőrizze, hogy biztonságos-e a megnyitás.
A parancsmag belsőleg Unblock-File
eltávolítja a Zone.Identifier alternatív adatfolyamot, amelynek értéke 3
azt jelzi, hogy az internetről lett letöltve.
A PowerShell végrehajtási szabályzataival kapcsolatos további információkért lásd: 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 letiltá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 könyvtárban található összes fájlt, amelynek a neve tartalmazza a C:\Downloads
"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 Fájlok lekérése a Zone.Identifier stream használatával.
A második parancs bemutatja, mi történik, ha letiltott szkriptet futtat egy PowerShell-munkamenetben, amelyben a végrehajtási szabályzat RemoteSigned. A RemoteSigned szabályzat 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
Jóváhagyá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írt módon 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
Bemutatja, mi történne a parancsmag futtatásakor. 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
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 Feloldás gomb a Tulajdonságok párbeszédpanelen a Fájlkezelő.- 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.