PowerShell
Application des prérequis du script
Recherche…
Syntaxe
- #Requires -Version <N> [. <N>]
- #Requires –PSSnapin <Nom PSSnapin> [-Version <N> [. <N>]]
- #Requires -Modules {<Nom-module> | <Hashtable>}
- #Requires –ShellId <ShellId>
- #Requires -RunAsAdministrator
Remarques
#requires instruction #requires peut être placée sur n'importe quelle ligne du script (il ne doit pas nécessairement s'agir de la première ligne), mais il doit s'agir de la première instruction sur cette ligne.
Plusieurs instructions #requires peuvent être utilisées dans un script.
Pour plus de référence, veuillez vous référer à la documentation officielle sur Technet - about_about_Requires .
Appliquer une version minimale de l'hôte powershell
#requires -version 4
Après avoir essayé d'exécuter ce script dans la version inférieure, vous verrez ce message d'erreur
. \ script.ps1: Le script 'script.ps1' ne peut pas être exécuté car il contient une instruction "#requires" à la ligne 1 pour Windows PowerShell version 5.0. La version requise par le script ne correspond pas à la version en cours d'exécution de Windows PowerShell version 2.0.
Exécuter le script en tant qu'administrateur
#requires -RunAsAdministrator
Après avoir essayé d'exécuter ce script sans privilèges d'administrateur, vous verrez ce message d'erreur
. \ script.ps1: Le script 'script.ps1' ne peut pas être exécuté car il contient une instruction "#requires" pour s'exécuter en tant qu'administrateur. La session Windows PowerShell en cours ne s'exécute pas en tant qu'administrateur. Démarrez Windows PowerShell en utilisant l'option Exécuter en tant qu'administrateur, puis essayez à nouveau d'exécuter le script.