Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Setlocal

Commence la localisation des variables d'environnement dans un fichier batch. La localisation se poursuit jusqu'à ce qu'une commande endlocal correspondante est trouvée ou la fin du fichier de commandes est atteinte.

Pour obtenir des exemples d'utilisation de cette commande, voir des exemples.

Syntaxe



setlocal [enableextensions | disableextensions] [enabledelayedexpansion | disabledelayedexpansion]

Arguments

Argument Description

ENABLEEXTENSIONS

Active les extensions de commandes jusqu'à ce que la commande endlocal correspondante soit rencontrée, quelle que soit sa valeur avant l'exécution de la commande setlocal.

DISABLEEXTENSIONS

Désactive les extensions de commande jusqu'à ce que la commande endlocal correspondante soit rencontrée, quelle que soit sa valeur avant l'exécution de la commande setlocal.

enabledelayedexpansion

Active l'expansion retardée environnement variable jusqu'à ce que la commande endlocal correspondante est rencontrée, quelle que soit sa valeur avant l'exécution de la commande setlocal .

disabledelayedexpansion

Désactive l'expansion retardée environnement variable jusqu'à ce que la commande endlocal correspondante est rencontrée, quelle que soit sa valeur avant l'exécution de la commande setlocal .

/?

Affiche l'aide à l'invite de commande.

Remarques

  • À l'aide de setlocal

    Lorsque vous utilisez setlocal en dehors d'un script ou un fichier batch, il est sans effet.

  • Modification des variables d'environnement

    Setlocal permet de modifier les variables d'environnement lorsque vous exécutez un fichier de commandes. Modifications d'environnement apportées après avoir exécuté setlocal sont locale au fichier de commandes. Le programme Cmd.exe restaure les paramètres précédents lorsqu'il rencontre une commande endlocal ou a atteint la fin du fichier de commandes.

  • Commandes d'imbrication

    Peut avoir plusieurs commandes setlocal ou endlocal dans un programme de commandes (c'est-à-dire, des commandes imbriquées).

  • Test des extensions de commandes dans des fichiers batch

    La commande setlocal définit la variable ERRORLEVEL. Si vous transmettez {enableextensions | disableextensions} ou {enabledelayedexpansion | disabledelayedexpansion}, la variable ERRORLEVEL est définie sur 0 (zéro). Dans le cas contraire, il est défini sur 1. Vous pouvez utiliser ces informations dans les scripts de commandes pour déterminer si les extensions sont disponibles, comme illustré dans l'exemple suivant :

    
    
    setlocal enableextensionsverify autres 2 > nulif errorlevel 1 echo Impossible d'activer les extensions
    
    
    Car cmd ne définit pas la variable ERRORLEVEL lorsque les extensions de commandes sont désactivées, la commande verify initialise la variable ERRORLEVEL à une valeur non nulle lorsque vous l'utilisez avec un argument non valide. En outre, si vous utilisez la commande setlocal avec les arguments {enableextensions | disableextensions} ou {enabledelayedexpansion | disabledelayedexpansion} et il ne définit pas la variable ERRORLEVEL à 1, les extensions de commandes ne sont pas disponibles.

Exemples

Vous pouvez localiser les variables d'environnement dans un fichier batch, comme illustré dans l'exemple de script suivant :



REM ******* commentaire Begin ************** rem Ce programme lance le commandes superapp sur le réseau, rem dirige la sortie vers un fichier et affiche le filerem dans le bloc-notes.

REM ******* fin Comment**************@echo offsetlocalpath=g:\programs\superapp;%path%call superapp > c:\superapp.outendlocalstart notepad c:\superapp.out

Références supplémentaires

Ajouts de la communauté

AJOUTER
Afficher: