setx 오류 Invalid syntax. Default option is not allowed more than '2' time(s) 트러블슈팅

※ 업무하면서 습득한 내용들을 정리해 놓은 포스팅입니다 :P 추가로 궁금하신 점은 댓글로 남겨주시고 필요한 자료 있으면 요청주세요! 잘못된 내용이 있으면 고쳐주시면 감사하겠습니다. 자료 퍼가실 때는 출처 남겨주세요!

---

 ο 목차

 

---

※ 코드 보는 방법 참고

ㅇ 달러 기호($)가 있는 경우 -> 리눅스 터미널에서 CLI 명령어 입력

ㅇ "=#" 기호가 있는 경우 -> psql 쉘에서 명령어 입력

ㅇ 꺽쇠가 하나 있는 경우(>) -> 윈도우 명령 프롬프트(cmd)에서 명령어 입력

ㅇ 꺽쇠가 세개 있는 경우(>>>) -> python 쉘에서 명령어 입력

---

1. 문제 사례

윈도우 cmd 창에서, 혹은 배치파일에서 setx 명령어를 사용해서 시스템 환경변수 추가시 해당 오류가 발생하며 환경 변수가 추가되지 않는 현상 발생

 

2. 오류 메세지 내용 상세

Error Invalid: Syntax. Default option is not allowed more than '2' time(s). Type "SETX /?" for usage.

 

3. 문제 원인

1) 오류가 발생하는 이유

 - setx 구문 오류로 어떤 이유로든지 1개의 값만 들어가야 하는 자리에 복수의 값이 들어가는 경우 해당 오류 발생.

 

4. 문제 해결 방법

※ 문제 해결 방법을 보기 전에 setx 프로그램 조작시 아래 내용 필참!!

 - setx로 환경변수 조작시 기존 path 값 백업해놓기 

 - setx로 환경변수를 조작하는 경우 현재 cmd 창에서는 변경된 내용 확인 안됨. 새로운 cmd 창을 열어 변경된 내용 확인하기

 

1)  path(시스템, 사용자 환경 변수) 경로 확인

 - cmd 창을 연 후 아래 명령어 입력하여 현재 환경 변수 설정값 확인

echo %PATH%

 

2) path 값에 잘못 사용된 Delimiters(구분자) 값이 있는지 확인

※ Delimiters(구분자) 란?

- 문자열의 시작과 끝을 알려주는 문자로 프로그램은 구분자를 기준으로 문자열을 각각의 별개 문자로 구분함

-  윈도우 CMD에서 사용되는 Delimiters 값들

Comma (,), Semicolon (;), Equals (=), Space ( ), Tab (    )

 

3) path 값에 쌍따옴표가 있는지 확인

 - setx 프로그램은 쌍따옴표("")로 쌓인 문자열을 하나의 문자열로 구분

 - path 값에 쌍따옴표가 포함되어 있고(예 : path = C:\WINDOWS\system32;C:\WINDOWS;"C:\WINDOWS\System32\Wbem;C:\WINDOWS\System32\WindowsPowerShell\v1.0\;"C:\WINDOWS\System32\OpenSSH\;) 아래와 같이 명령어를 사용하는 경우,, path 내부의 쌍따옴표와 명령어의 쌍따옴표가 중첩되어 프로그램 상에서 1개 이상의 문자열로 인식됨

setx path "%PATH%;추가할경로"

  - path 값에 포함된 쌍따옴표를 없애주면 정상적으로 동작

 

5) 사용자 환경 변수 값 초기화하기

 - 도저히 원인을 찾지 못하는 경우 아래와 같이 사용자 환경 변수 값을 초기화하면 오류가 해소되는 경우가 있음.

(기존 사용자 변수 설정 백업 후, 하나씩 추가해보면서 잘못된 부분 찾기)

setx path ""

※ 위의 명령어를 사용하는 경우 시스템 환경 변수는 그대로 유지됨.

 

 

저는 3) 이 원인이어서 path 내부의 사용자 환경 변수의 "" 부분을 없애고 나니 정상적으로 동작했습니다.

 

/m 옵션을 주면 해결된다는 분들도 있던데,, /m 옵션을 주게 되면 시스템 환경 변수가 변경됩니다. 

잘 모르는 상태에서 시스템 환경 변수를 건드리는 건 좋은 생각이 아닙니다...

 

웬만하면 사용자 환경 변수값 조정으로 문제를 해결하시길 바랍니다.

---

※ 좋아요와 구독은 큰 힘이 됩니다. 감사합니다.