Partager via

Unblock-File

  • Référence
Module:
Microsoft.PowerShell.Utility

Débloque les fichiers téléchargés à partir d’Internet.

Syntaxe

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

Description

Cette applet de commande fonctionne uniquement sur les plateformes Windows et macOS.

L’applet Unblock-File de commande vous permet d’ouvrir des fichiers téléchargés à partir d’Internet. Il débloque les fichiers de script PowerShell qui ont été téléchargés à partir d’Internet afin de pouvoir les exécuter, même lorsque la stratégie d’exécution de PowerShell est RemoteSigned. Par défaut, ces fichiers sont bloqués pour protéger l'ordinateur contre les fichiers non approuvés.

Avant d’utiliser l’applet Unblock-File de commande, passez en revue le fichier et sa source et vérifiez qu’il est sûr de s’ouvrir.

En interne, l’applet Unblock-File de commande supprime le flux de données de remplacement Zone.Identifier , qui a la valeur d’indiquer 3 qu’il a été téléchargé à partir d’Internet.

Pour plus d’informations sur les stratégies d’exécution de PowerShell, consultez about_Execution_Policies.

Cette applet de commande a été introduite dans Windows PowerShell 3.0.

Exemples

Exemple 1 : Débloquer un fichier

Cette commande débloque le PowerShellTips.chm fichier.

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

Exemple 2 : Débloquer plusieurs fichiers

Cette commande débloque tous les fichiers du C:\Downloads répertoire dont les noms incluent « PowerShell ». N'exécutez pas une commande similaire à celle-ci tant que vous n'avez pas vérifié que tous les fichiers étaient sûrs.

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

Exemple 3 : Rechercher et débloquer des scripts

Cette commande montre comment rechercher et débloquer des scripts PowerShell.

La première commande utilise le paramètre Stream de l’applet de commande Get-Item get files with the Zone.Identifier stream.

La deuxième commande montre ce qui se passe lorsque vous exécutez un script bloqué dans une session PowerShell dans laquelle la stratégie d’exécution est RemoteSigned. La stratégie RemoteSigned vous empêche d’exécuter des scripts téléchargés à partir d’Internet, sauf s’ils sont signés numériquement.

La troisième commande utilise l’applet Unblock-File de commande pour débloquer le script afin qu’il puisse s’exécuter dans la session.

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ètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LiteralPath

Spécifie les fichiers à débloquer. Contrairement à Path, la valeur du paramètre LiteralPath est utilisée exactement comme elle est typée. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin inclut des caractères d’échappement, placez-le entre guillemets simples ('). Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Type:String[]
Alias:PSPath, LP
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Path

Spécifie les fichiers à débloquer. Les caractères génériques sont pris en charge.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger un chemin d’accès de fichier vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

  • La prise en charge de macOS a été ajoutée dans PowerShell 7.
  • L’applet Unblock-File de commande fonctionne uniquement dans les lecteurs du système de fichiers.
  • Unblock-Fileeffectue la même opération que le bouton Débloquer dans la boîte de dialogue Propriétés dans Explorateur de fichiers.
  • Si vous utilisez l’applet Unblock-File de commande sur un fichier qui n’est pas bloqué, la commande n’a aucun effet sur le fichier déblocé et l’applet de commande ne génère pas d’erreurs.