Dela via

Unblock-File

  • Referens
Modul:
Microsoft.PowerShell.Utility

Avblockeras filer som har laddats ned från Internet.

Syntax

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

Description

Med cmdleten Avblockera fil kan du öppna filer som har laddats ned från Internet. PowerShell-skriptfiler som har laddats ned från Internet avblockeras så att du kan köra dem, även när PowerShell-körningsprincipen är RemoteSigned. Som standard blockeras dessa filer för att skydda datorn mot obetrodda filer.

Innan du använder cmdleten Unblock-File granskar du filen och dess källa och kontrollerar att den är säker att öppna.

Internt tar cmdleten Unblock-File bort den alternativa dataströmmen Zone.Identifier, som har värdet "3" som anger att den har laddats ned från Internet.

Mer information om PowerShell-körningsprinciper finns i about_Execution_Policies.

Denna cmdlet introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Avblockera en fil

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

Det här kommandot avblockera Filen PowerShellTips.chm.

Exempel 2: Avblockera flera filer

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

Det här kommandot avblockera alla filer i katalogen C:\Downloads vars namn inkluderar "PowerShell". Kör inte ett kommando som det här förrän du har kontrollerat att alla filer är säkra.

Exempel 3: Hitta och avblockera skript

The first command uses the *Stream* parameter of the Get-Item cmdlet get files with the Zone.Identifier stream.Although you could pipe the output directly to the **Unblock-File** cmdlet (Get-Item * -Stream "Zone.Identifier" -ErrorAction SilentlyContinue | ForEach {Unblock-File $_.FileName}), it is prudent to review the file and confirm that it is safe before unblocking.
PS C:\> Get-Item * -Stream "Zone.Identifier" -ErrorAction SilentlyContinue
   FileName: C:\ps-test\Start-ActivityTracker.ps1

Stream                   Length
------                   ------
Zone.Identifier              26

The second command shows what happens when you run a blocked script in a PowerShell session in which the execution policy is **RemoteSigned**. The RemoteSigned policy prevents you from running scripts that are downloaded from the Internet unless they are digitally signed.
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

The third command uses the **Unblock-File** cmdlet to unblock the script so it can run in the session.
PS C:\> Get-Item C:\ps-test\Start-ActivityTracker.ps1 | Unblock-File

Det här kommandot visar hur du hittar och avblockera PowerShell-skript.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Anger vilka filer som ska avblockeras. Till skillnad från Path används värdet för parametern LiteralPath exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den inom enkla citattecken. Enkla citattecken säger till PowerShell att inte tolka några tecken som escape-sekvenser.

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

-Path

Anger vilka filer som ska avblockeras. Jokertecken stöds.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

Du kan skicka en filsökväg till Avblockera fil.

Utdata

None

Den här cmdleten genererar inga utdata.

Kommentarer

  • Cmdleten Unblock-File fungerar endast på filsystemenheter.
  • Avblockera fil utför samma åtgärd som knappen Avblockera i dialogrutan Egenskaper i Utforskaren.
  • Om du använder cmdleten Unblock-File på en fil som inte är blockerad har kommandot ingen effekt på den avblockerade filen och cmdleten genererar inga fel.