RUBRIQUE about_Requires DESCRIPTION COURTE Empêche l'exécution d'un script en requérant la version et les composants logiciels enfichables spécifiés. DESCRIPTION LONGUE L'instruction #Requires empêche l'exécution d'un script si les conditions préalables liées à la version de Windows PowerShell, au composant logiciel enfichable et à la version de ce composant ne sont pas remplies. Si les conditions préalables ne sont pas remplies, Windows PowerShell n'exécute pas le script. Vous pouvez utiliser les instructions #Requires dans n'importe quel script. Vous ne pouvez pas les utiliser dans les fonctions, applets de commande ni composants logiciels enfichables. Syntaxe Utilisez la syntaxe suivante pour spécifier le composant logiciel enfichable et la version du composant logiciel enfichable que vous souhaitez requérir : #requires -PsSnapIn <PsSnapIn> [-Version <N>[.<n>]] Utilisez la syntaxe suivante pour spécifier la version minimale de Windows PowerShell que vous souhaitez requérir : #requires -Version <N>[.<n>] Utilisez la syntaxe suivante pour spécifier l'interpréteur de commandes que vous souhaitez requérir : #requires -ShellId <ShellId> Règles d'utilisation - L'instruction #Requires doit être le premier élément sur une ligne d'un script. - Un script peut inclure plusieurs instructions #Requires. - Les instructions #Requires peuvent apparaître sur n'importe quelle ligne d'un script. Exemples L'instruction suivante requiert le composant logiciel enfichable Microsoft.PowerShell.Security : #requires -PsSnapIn Microsoft.PowerShell.Security Si le composant logiciel enfichable Microsoft.PowerShell.Securit y n'est pas chargé, le script ne s'exécute pas et Windows PowerShell affiche le message d'erreur suivant : " Le script <nom-script> ne peut pas être exécuté, car les composants logiciels enfichables Windows PowerShell suivants, spécifiés par les instructions #requires du script, sont absents : Microsoft.PowerShell.Security ". L'instruction suivante requiert Windows PowerShell version 2.0 ou toute version ultérieure du composant logiciel enfichable Microsoft.PowerShell.Security : #requires -PsSnapIn Microsoft.PowerShell.Security -Version 2 L'instruction suivante requiert Windows PowerShell 2.0 ou une version ultérieure : #requires -Version 2.0 Le script suivant a deux instructions #Requires. Les conditions spécifiées dans les deux instructions doivent être remplies. Sinon, le script ne s'exécutera pas. Chaque instruction #Requires doit être le premier élément sur une ligne : #requires -PsSnapIn Microsoft.PowerShell.Security -Version 2 Get-WMIObject WIN32_LogicalDisk | out-file K:\status\DiskStatus.txt #requires -Version 2 L'instruction #Requires suivante empêche l'exécution d'un script si l'ID de l'interpréteur de commandes spécifié ne correspond pas à l'ID de l'interpréteur de commandes actuel. L'ID de l'interpréteur de commandes actuel est stocké dans la variable $ShellId : #requires -ShellId MyLocalShell VOIR AUSSI about_Automatic_Variables about_Language_Keywords about_PSSnapins get-PSSnapin