usermod:ko [Command Line Interface Helper]

이 문서는 읽기 전용입니다. 원본을 볼 수는 있지만 바꿀 수는 없습니다. 문제가 있다고 생각하면 관리자에게 문의하세요.
{{tag>[cli shadow-utils user administration]}}

====== usermod ======
기존 로컬 사용자 계정의 이름, 그룹, 홈, 셸, 만료 정책 등을 변경하는 shadow-utils 명령이다.

===== Installation =====
  * Debian / Ubuntu: ''sudo apt install passwd''
  * RHEL / Fedora: ''sudo dnf install shadow-utils''
  * macOS와 Windows는 다른 계정 관리 체계를 사용한다.
<code bash>
usermod --help
</code>

===== Usage =====
  * ''<color #c3c3c3>**usermod**</color> <color #22b14c>[OPTIONS]</color> <color #7092be>LOGIN</color>''
  * ''<color #22b14c>**-a**, **--append**</color>'': ''-G''와 함께 기존 보조 그룹을 유지하며 추가
  * ''<color #22b14c>**-G**, **--groups**</color> <color #7092be>GROUPS</color>'': 보조 그룹 목록 교체
  * ''<color #22b14c>**-g**, **--gid**</color> <color #7092be>GROUP</color>'': 기본 그룹 변경
  * ''<color #22b14c>**-d**, **--home**</color> <color #7092be>HOME_DIR</color>'': 홈 경로 변경
  * ''<color #22b14c>**-m**, **--move-home**</color>'': ''-d''와 함께 기존 홈 내용 이동
  * ''<color #22b14c>**-l**, **--login**</color> <color #7092be>NEW_LOGIN</color>'': 로그인 이름 변경
  * ''<color #22b14c>**-s**, **--shell**</color> <color #7092be>SHELL</color>'': 로그인 셸 변경
  * ''<color #22b14c>**-L**, **--lock**</color>'': password 잠금
  * ''<color #22b14c>**-U**, **--unlock**</color>'': password 잠금 해제
  * ''<color #22b14c>**-e**, **--expiredate**</color> <color #7092be>YYYY-MM-DD</color>'': 계정 만료일 변경

===== Examples =====
<code bash>
sudo usermod -aG GROUP "$USER"
sudo usermod -s /bin/bash alice
sudo usermod -d /srv/home/alice -m alice
sudo usermod --expiredate 2026-12-31 contractor
</code>

<note warning>
''usermod -G''만 사용하면 기존 보조 그룹 목록을 교체한다. 기존 그룹을 유지하며 추가할 때는 반드시 ''-aG''를 함께 사용한다. 그룹 변경은 사용자가 새 session에 로그인한 뒤 반영된다.
</note>

===== Help =====
+++ usermod --help |
<code bash>
usermod --help
</code>
+++

===== See Also =====
  * [[id:ko]]
  * [[useradd:ko]]
  * [[userdel:ko]]
  * [[passwd:ko]]
  * [[https://man7.org/linux/man-pages/man8/usermod.8.html|usermod(8) manual]]

===== History =====
  * codex:: 2026-08-10 Migrated and expanded the page while preserving the recorded append-to-group command.

{{indexmenu>.#1|js}}