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, 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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-FileUgyanazt 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.