Unblock-File
Feloldja az internetről letöltött fájlok letiltását.
Syntax
ByPath (Alapértelmezett)
Unblock-File
[-Path] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByLiteralPath
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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 escape karaktereket tartalmaz, tedd egyes idézőjelbe ('). Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath, LP |
Paraméterkészletek
ByLiteralPath
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Path
Megadja a letiltani kívánt fájlokat. A helyettesítő karakterek támogatottak.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
ByPath
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
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-Fileparancsmag csak fájlrendszer-meghajtókon működik. -
Unblock-Fileugyanazt 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-Fileparancsmagot nem blokkolt fájlon használja, a parancsnak nincs hatása a feloldott fájlra, és a parancsmag nem okoz hibákat.