SETLOCAL: Lokalisatie van wijzigingen in de systeemomgeving in een batchbestand starten.
Het commando: "SETLOCAL" staat aan Windows 11, 10, .. beschikbaar
"SETLOCAL" Fragment uit Microsoft Windows Help
Microsoft Windows [Version 10.0.19045.3693]
(c) Copyright 1985-2023 Microsoft Corp.
C:\\Windows>
Begint lokalisatie van omgevingswijzigingen in een batchbestand.
Omgevingswijzigingen die zijn gemaakt nadat SETLOCAL is
uitgegeven, zijn
alleen geldig binnen het batchbestand. Als het einde van een
batchscript
is bereikt, wordt een ENDLOCAL uitgevoerd voor alle resterende
SETLOCAL-
opdrachten die zijn uitgegeven door het batchscript.
SETLOCAL
Als opdrachtextensies zijn ingeschakeld, verandert SETLOCAL als
volgt:
Batchopdracht SETLOCAL accepteert nu optionele argumenten:
ENABLEEXTENSIONS / DISABLEEXTENSIONS
schakelt opdrachtprocessorextensies in of uit. Typ
CMD /? voor details.
ENABLEDELAYEDEXPANSION / DISABLEDELAYEDEXPANSION
schakelt vertraagde uitbreiding van
omgevingsvariabele
in of uit. Typ SET /? voor details.
Deze wijzigingen blijven van toepassing tot de overeenkomende
opdracht
ENDLOCAL, ongeacht de instelling ervan vóór de opdracht SETLOCAL.
Opdracht SETLOCAL zal de waarde ERRORLEVEL instellen als hieraan
een
argument is gegeven. Het zal nul zijn als een van de twee geldige
argumenten
is gegeven en één indien dit niet het geval is. U kunt dit in
batchscripts
gebruiken om te bepalen of de extensies beschikbaar zijn, via de
volgende
methode:
VERIFY OTHER 2>nul
SETLOCAL ENABLEEXTENSIONS
IF ERRORLEVEL 1 echo Kan extensies niet inschakelen
Dit zal werken omdat SETLOCAL bij oude versies van CMD.EXE de
waarde
ERRORLEVEL NIET instelt. De opdracht VERIFY met een ongeldig
argument
initialiseert de waarde ERRORLEVEL op een waarde niet-nul.
De voorbeelden voor het commando "SETLOCAL"
De
`SETLOCAL`opdracht in de Windows-opdrachtprompt wordt gebruikt om omgevingsvariabelen lokaal in een batchbestand in te stellen. Hier zijn enkele voorbeelden van het gebruik
`SETLOCAL`:
Voorbeeld 1: Lokale omgevingsvariabele instellen:
@ECHO OFF
SETLOCAL
SET LOKAAL_VARIABLE=Inhoud
ECHO %LOKAAL_VARIABLE%
Beschrijving: In dit voorbeeld de omgevingsvariabele
`LOKAAL_VARIABLE`binnen het plaatselijk beperkte gebied (via
`SETLOCAL`En
`ENDLOCAL`) en kan alleen binnen dit bereik worden gebruikt.
Voorbeeld 2: Terugzetten naar vorige status:
@ECHO OFF
SET GLOBALE_VARIABLE=Globale_Inhoud
SETLOCAL
SET LOKAAL_VARIABLE=Lokale_inhoud
ECHO Lokaal Variable: %LOKAAL_VARIABLE%
ECHO Globale Variable: %GLOBALE_VARIABLE%
ENDLOCAL
ECHO Lokaal Variable (buiten het plaatselijk beperkte gebied): %LOKAAL_VARIABLE%
Beschrijving: Dit is de lokale omgevingsvariabele
`LOKAAL_VARIABLE`ingesteld en gebruikt binnen het plaatselijk beperkte gebied. Na
`ENDLOCAL`het script keert terug naar de vorige staat en de lokale variabele is niet langer beschikbaar buiten het lokale bereik.
Voorbeeld 3: SETLOCAL nesten:
@ECHO OFF
SETLOCAL
SET VARIABLE1=Waarde1
ECHO Binnengebied: %VARIABLE1%
SETLOCAL
SET VARIABLE2=Waarde2
ECHO Extern gebied: %VARIABLE1%, %VARIABLE2%
ENDLOCAL
ECHO Buiten de lokale omgeving: %VARIABLE1%, %VARIABLE2%
Beschrijving: Dit is waar de
`SETLOCAL`-Commando twee keer genest. De variabele
`VARIABLE2`is alleen zichtbaar in het binnenste gelokaliseerde gebied, terwijl
`VARIABLE1`is zichtbaar in de externe en interne gebieden.
Voorbeeld 4: Geavanceerde verwerking van omgevingsvariabelen inschakelen:
@ECHO OFF
SETLOCAL ENABLEDELAYEDEXPANSION
SET VARIABLE=Inhoud
ECHO Voordat uitgesteld Expansion: %VARIABLE%
SET VARIABLE=Nieuwe inhoud
ECHO Na uitgesteld Expansion: !VARIABLE!
Beschrijving: Door gebruik te maken van
`ENABLEDELAYEDEXPANSION`kunnen omgevingsvariabelen met een uitroepteken bevatten
`!`in plaats van procenttekens
`%`worden gebruikt voor vertraagde expansie.
De
`SETLOCAL`In de omgeving kunnen variabelen lokaal worden ingesteld voor een batchbestand, waardoor wijzigingen alleen van toepassing zijn op een beperkt gebied en niet globaal op het hele script. Dit is met name handig als u wilt dat wijzigingen in omgevingsvariabelen beperkt blijven tot een specifiek gedeelte van het script.
Belangrijke informatie, tips voor het "SETLOCAL" commando
Ja, er zijn enkele belangrijke aspecten waarmee u rekening moet houden wanneer u
`SETLOCAL`opdracht in de Windows-opdrachtprompt of in batchscripts:
1.
Beperkte reikwijdte: `SETLOCAL`creëert een beperkte ruimte voor omgevingsvariabelen. Wijzigingen in omgevingsvariabelen binnen dit bereik hebben geen invloed op de mondiale omgeving of andere gelokaliseerde bereiken. Let daar op
`SETLOCAL`En
`ENDLOCAL`moet in paren worden gebruikt.
SETLOCAL
REM ... Hier zijn veranderingen in omgevingsvariabelen lokaal
ENDLOCAL
2.
Nesten: Dat kan
`SETLOCAL`nesten om meerdere gelokaliseerde gebieden te creëren. Iedereen
`SETLOCAL`maar het zou met een geschikte moeten zijn
`ENDLOCAL`worden beëindigd.
SETLOCAL
REM Binnenste gelokaliseerd gebied
SETLOCAL
REM Nog dieper gelokaliseerd gebied
ENDLOCAL
ENDLOCAL
3.
Vertraagde uitbreiding: Dat kan met
`SETLOCAL ENABLEDELAYEDEXPANSION`activeer vertraagde expansie. De variabele is inbegrepen
`!`in plaats van
`%`ingesloten. Dankzij luie uitbreiding kunnen variabelen tijdens runtime worden geëvalueerd, en niet alleen tijdens het lezen van het batchbestand.
SETLOCAL ENABLEDELAYEDEXPANSION
SET VARIABLE=Inhoud
ECHO Voordat uitgesteld Expansion: %VARIABLE%
SET VARIABLE=Nieuwe inhoud
ECHO Na uitgesteld Expansion: !VARIABLE!
ENDLOCAL
4.
Globale omgevingsvariabelen: Wijzigingen in omgevingsvariabelen die zich binnen a bevinden
`SETLOCAL`-scope heeft geen invloed op de mondiale omgevingsvariabelen buiten de scope.
SET GLOBAL=Globale_Inhoud
SETLOCAL
SET GLOBAL=Lokale_inhoud
ECHO Binnen het plaatselijk beperkte gebied: %GLOBAL%
ENDLOCAL
ECHO Buiten de lokale omgeving: %GLOBAL%
5.
Wijzigingen ongedaan maken: Als u wijzigingen in een gelokaliseerd gebied ongedaan wilt maken, keert u eenvoudigweg terug naar de staat ervoor
`SETLOCAL`terug bij jou
`ENDLOCAL`gebruik.
SETLOCAL
REM Veranderingen hier
ENDLOCAL
REM Maak de wijzigingen ongedaan
Het is belangrijk,
`SETLOCAL`En
`ENDLOCAL`zorgvuldig en in paren te gebruiken om ervoor te zorgen dat omgevingsvariabelen correct worden beperkt en de verwachte effecten hebben.
