Dela via

Unblock-File

Modul:
Microsoft.PowerShell.Utility Module

Avblockera filer som har laddats ned från Internet.

Syntax

ByPath (Standard) 

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

ByLiteralPath 

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

Description

Den här cmdleten fungerar bara på Windows- och macOS-plattformarna.

Med cmdleten Unblock-File 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 från ej betrodda 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 Zone.Identifier alternativa dataström, 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.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Avblockera en fil

Det här kommandot avblockera PowerShellTips.chm-filen.

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

Exempel 2: Avblockera flera filer

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.

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

Exempel 3: Hitta och avblockera skript

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

Det första kommandot använder parametern Stream i cmdleten Get-Item hämta filer med Zone.Identifier stream.

Det andra kommandot visar vad som händer när du kör ett blockerat skript i en PowerShell-session där körningsprincipen RemoteSigned. Principen RemoteSigned hindrar dig från att köra skript som laddas ned från Internet om de inte är digitalt signerade.

Det tredje kommandot använder cmdleten Unblock-File för att avblockera skriptet så att det kan köras i sessionen.

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

Parametrar

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-LiteralPath

Anger vilka filer som ska avblockeras. Till skillnad från Pathanvänds värdet för parametern LiteralPath precis som det skrivs. Inga tecken tolkas som wildcards. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken ('). Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PSPath, SP

Parameteruppsättningar

ByLiteralPath
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Path

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

ByPath
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Du kan skicka en filsökväg till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

  • Stöd för macOS har lagts till i PowerShell 7.
  • Cmdleten Unblock-File fungerar endast på filsystemenheter.
  • Unblock-File 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 blockeras har kommandot ingen effekt på den avblockerade filen och cmdleten genererar inga fel.