|
|
Zeile 172: |
Zeile 172: |
| = TMP = | | = TMP = |
| USERMOD(8) System Management Commands USERMOD(8) | | USERMOD(8) System Management Commands USERMOD(8) |
|
| |
| == OPTIONEN ==
| |
|
| |
| -a, --append
| |
| Add the user to the supplementary group(s). Use only with the -G option.
| |
|
| |
| -b, --badname
| |
| erlaube Namen, die nicht den Standards entsprechen.
| |
|
| |
| -c, --comment COMMENT
| |
| update the comment field of the user in /etc/passwd, which is normally modified using the chfn(1) utility.
| |
|
| |
| -d, --home HOME_DIR
| |
| ändert das persönliche Verzeichnis des Benutzers
| |
|
| |
| If the -m option is given, the contents of the current home directory will be moved to the new home directory, which is created if it does not
| |
| already exist. If the current home directory does not exist the new home directory will not be created.
| |
|
| |
| -e, --expiredate EXPIRE_DATE
| |
| The date on which the user account will be disabled. The date is specified in the format YYYY-MM-DD. Integers as input are interpreted as days
| |
| after 1970-01-01.
| |
|
| |
| An input of -1 or an empty string will blank the account expiration field in the shadow password file. The account will remain available with no
| |
| date limit.
| |
|
| |
| This option requires a /etc/shadow file. A /etc/shadow entry will be created if there were none.
| |
|
| |
| -f, --inactive INACTIVE
| |
| defines the number of days after the password exceeded its maximum age during which the user may still login by immediately replacing the password.
| |
| This grace period before the account becomes inactive is stored in the shadow password file. An input of 0 will disable an expired password with no
| |
| delay. An input of -1 will blank the respective field in the shadow password file. See shadow(5) for more information.
| |
|
| |
| This option requires a /etc/shadow file. A /etc/shadow entry will be created if there were none.
| |
|
| |
| -g, --gid GROUP
| |
| The name or numerical ID of the user's new primary group. The group must exist.
| |
|
| |
| Im persönlichen Verzeichnis des Benutzers werden alle Dateien, die der alten primären Gruppe zugeordnet waren, auf diese Gruppe übertragen.
| |
|
| |
| Die Gruppenzugehörigkeit von Dateien außerhalb des persönlichen Verzeichnisses des Benutzers muss per Hand angepasst werden.
| |
|
| |
| The change of the group ownership of files inside of the user's home directory is also not done if the home dir owner uid is different from the
| |
| current or new user id. This is a safety measure for special home directories such as /.
| |
|
| |
| -G, --groups GROUP1[,GROUP2,...[,GROUPN]]]
| |
| A list of supplementary groups which the user is also a member of. Each group is separated from the next by a comma, with no intervening
| |
| whitespace. The groups must exist.
| |
|
| |
| If the user is currently a member of a group which is not listed, the user will be removed from the group. This behaviour can be changed via the -a
| |
| option, which appends the user to the current supplementary group list.
| |
|
| |
| -l, --login NEW_LOGIN
| |
| The name of the user will be changed from LOGIN to NEW_LOGIN. Nothing else is changed. In particular, the user's home directory or mail spool
| |
| should probably be renamed manually to reflect the new login name.
| |
|
| |
| -L, --lock
| |
| Lock a user's password. This puts a '!' in front of the encrypted password, effectively disabling the password. You can't use this option with -p
| |
| or -U.
| |
|
| |
| Note: if you wish to lock the account (not only access with a password), you should also set the EXPIRE_DATE to 1.
| |
|
| |
| -m, --move-home
| |
| moves the content of the user's home directory to the new location. If the current home directory does not exist the new home directory will not be
| |
| created.
| |
|
| |
| This option is only valid in combination with the -d (or --home) option.
| |
|
| |
| usermod will try to adapt the ownership of the files and to copy the modes, ACL and extended attributes, but manual changes might be needed
| |
| afterwards.
| |
|
| |
| -o, --non-unique
| |
| allows to change the user ID to a non-unique value.
| |
|
| |
| This option is only valid in combination with the -u option. As a user identity serves as key to map between users on one hand and permissions,
| |
| file ownerships and other aspects that determine the system's behavior on the other hand, more than one login name will access the account of the
| |
| given UID.
| |
|
| |
| -p, --password PASSWORD
| |
| defines a new password for the user. PASSWORD is expected to be encrypted, as returned by crypt (3).
| |
|
| |
| Note: Avoid this option on the command line because the password (or encrypted password) will be visible by users listing the processes.
| |
|
| |
| The password will be written in the local /etc/passwd or /etc/shadow file. This might differ from the password database configured in your PAM
| |
| configuration.
| |
|
| |
| Sie sollten sicherstellen, dass das Passwort den Passwortrichtlinien des Systems entspricht.
| |
|
| |
| -r, --remove
| |
| Remove the user from named supplementary group(s). Use only with the -G option.
| |
|
| |
| -R, --root CHROOT_DIR
| |
| Apply changes in the CHROOT_DIR directory and use the configuration files from the CHROOT_DIR directory. Only absolute paths are supported.
| |
|
| |
| -P, --prefix PREFIX_DIR
| |
| Apply changes within the directory tree starting with PREFIX_DIR and use as well the configuration files located there. This option does not chroot
| |
| and is intended for preparing a cross-compilation target. Some limitations: NIS and LDAP users/groups are not verified. PAM authentication is using
| |
| the host files. No SELINUX support.
| |
|
| |
| -s, --shell SHELL
| |
| changes the user's login shell. An empty string for SHELL blanks the field in /etc/passwd and logs the user into the system's default shell.
| |
|
| |
| -u, --uid UID
| |
| The new value of the user's ID.
| |
|
| |
| This value must be unique, unless the -o option is used. The value must be non-negative.
| |
|
| |
| Für das Postfach des Benutzers und alle Dateien, die ihm gehören und sich in seinem persönlichen Verzeichnis befinden, wird die Eigentümerkennung
| |
| automatisch angepasst.
| |
|
| |
| Der Eigentümer von Dateien außerhalb des persönlichen Verzeichnisses des Benutzers muss per Hand angepasst werden.
| |
|
| |
| The change of the user ownership of files inside of the user's home directory is also not done if the home dir owner uid is different from the
| |
| current or new user id. This is a safety measure for special home directories such as /.
| |
|
| |
| No checks will be performed with regard to the UID_MIN, UID_MAX, SYS_UID_MIN, or SYS_UID_MAX from /etc/login.defs.
| |
|
| |
| -U, --unlock
| |
| Unlock a user's password. This removes the '!' in front of the encrypted password. You can't use this option with -p or -L.
| |
|
| |
| Note: if you wish to unlock the account (not only access with a password), you should also set the EXPIRE_DATE (for example to 99999, or to the
| |
| EXPIRE value from /etc/default/useradd).
| |
|
| |
| -v, --add-subuids FIRST-LAST
| |
| fügt dem Konto des Benutzers einen Bereich untergeordneter Benutzerkennungen zu.
| |
|
| |
| This option may be specified multiple times to add multiple ranges to a user's account.
| |
|
| |
| No checks will be performed with regard to SUB_UID_MIN, SUB_UID_MAX, or SUB_UID_COUNT from /etc/login.defs.
| |
|
| |
| -V, --del-subuids FIRST-LAST
| |
| entfernt aus dem Benutzerkonto einen Bereich untergeordneter Benutzerkennungen.
| |
|
| |
| This option may be specified multiple times to remove multiple ranges to a user's account. When both --del-subuids and --add-subuids are specified,
| |
| the removal of all subordinate uid ranges happens before any subordinate uid range is added.
| |
|
| |
| No checks will be performed with regard to SUB_UID_MIN, SUB_UID_MAX, or SUB_UID_COUNT from /etc/login.defs.
| |
|
| |
| -w, --add-subgids FIRST-LAST
| |
| fügt dem Benutzerkonto einen Bereich untergeordneter Gruppenkennungen zu.
| |
|
| |
| This option may be specified multiple times to add multiple ranges to a user's account.
| |
|
| |
| No checks will be performed with regard to SUB_GID_MIN, SUB_GID_MAX, or SUB_GID_COUNT from /etc/login.defs.
| |
|
| |
| -W, --del-subgids FIRST-LAST
| |
| entfernt einen Bereich untergeordneter Gruppenkennungen aus dem Benutzerkonto.
| |
|
| |
| This option may be specified multiple times to remove multiple ranges to a user's account. When both --del-subgids and --add-subgids are specified,
| |
| the removal of all subordinate gid ranges happens before any subordinate gid range is added.
| |
|
| |
| No checks will be performed with regard to SUB_GID_MIN, SUB_GID_MAX, or SUB_GID_COUNT from /etc/login.defs.
| |
|
| |
| -Z, --selinux-user SEUSER
| |
| defines the SELinux user to be mapped with LOGIN. An empty string ("") will remove the respective entry (if any). Note that the shadow system
| |
| doesn't store the selinux-user, it uses semanage(8) for that.
| |
|
| |
| --selinux-range SERANGE
| |
| defines the SELinux MLS range for the new account. Note that the shadow system doesn't store the selinux-range, it uses semanage(8) for that.
| |
|
| |
| This option is only valid if the -Z (or --selinux-user) option is specified.
| |
usermod - verändert ein Benutzerkonto
Beschreibung
The usermod command modifies the system account files.
Installation
- Debian Paket passwd
- sollte in jeder Linux-Installation vorhanden sein
- shadow-utils 4.16.0
- 05.08.2024
- USERMOD(8)
Anwendung
Benutzer umbenennen
Benutzer anton in zander umbenennen
sudo usermod -l zander anton
Home-Verzeichnis ändern
Benutzer berta in das neue Heimatverzeichnis /earth2/admins/berta umziehen
sudo usermod -d /earth2/admins/berta -m berta
Benutzer sperren
Benutzer chris sperren
Loginshell ändern
Shell für diana auf /bin/fish setzen
sudo usermod -s /bin/fish diana
Benutzer/Gruppen-ID ändern
Benutzer ID und Gruppen ID von z. B. 1003 in 1000 ändern
sudo pgrep -U else|xargs kill -9
sudo usermod -u 1000 else
sudo groupmod -g 1000 else
Benutzer in Gruppe aufnehmen
Benutzer www-data in die Gruppe redis aufnehmen
# usermod -a -G redis www-data
Benutzer else in die Gruppe sudo aufnehmen (alle anderen Gruppenzugehörigkeiten von else bleiben erhalten)
sudo usermod -aG sudo else
Syntax
sudo usermod [Optionen] LOGIN
Optionen
Unix |
GNU |
Parameter |
Beschreibung
|
-a |
|
|
Benutzer zur Gruppen hinzufügen, die mit der Option -G angegeben werden, ohne ihn dabei aus anderen Gruppen zu entfernen.
- Unbedingt die obige Warnung beachten!
|
-c |
|
Kommentar |
(neues) Kommentarfeld des Benutzers in der Passwort-Datei
|
-d |
|
Heimverzeichnis [-m] |
Das neue Heimatverzeichnis des Benutzers.
- Wird die Option -m angegeben, so werden die Dateien aus dem alten Heimatverzeichnis in das neue verschoben, falls dieses noch nicht existiert wird es angelegt
|
-e |
|
Erlöschungsdatum |
Datum, bis zu dem das Benutzerkonto gültig sein soll.
- Das Datum ist im Format YYYY-MM-DD anzugeben
|
-f |
|
Inaktive Tage |
Die Anzahl der Tage, die vergehen bis das Konto permanent erlischt, nachdem das zugehörige Passwort abgelaufen ist.
- Ein Wert von 0 deaktiviert das Account sobald das Passwort seine Gültigkeit verliert.
- Ein Wert von -1 schaltet dieses Feature ganz ab.
- Der Standardwert ist -1
|
-g |
|
Initial-Gruppe |
Der Name oder die Nummer der Gruppe, der der Benutzer zu Beginn zugewiesen sein soll.
- Die angegebene Gruppe muss bereits existieren! Standard ist Gruppe 1, oder was immer in /etc/default/useradd angegeben ist
|
-G |
|
Gruppe,[...] |
Liste von zusätzlichen Gruppen, denen der Benutzer neben der Initial-Gruppe zugeordnet werden soll.
- Jede Gruppe wird von der nächsten durch ein Komma (ohne Leerzeichen dazwischen) getrennt.
- Die Gruppen unterliegen dabei den selben Einschränkungen wie die Initial-Gruppe, die in der -g-Option angegeben wird.
- Unbedingt die obige Warnung beachten!
|
-l |
|
NEUER_NAME |
Der Name des Benutzers wird von seinem alten Namen (login) in NEUER_NAME geändert
|
-p |
|
passwd |
Das verschlüsselte Passwort, wie es von crypt zurückgeliefert wird.
- Standardmäßig wird das Konto deaktiviert.
- Anmerkung: um das Passwort zu ändern eignet sich passwd eigentlich besser
|
-s |
|
shell |
Der Name der Login-Shell für den Benutzer.
- Der Standard ist, dieses Feld leer zu lassen, was dazu führt, dass das System die Standard Login-Shell verwendet
|
-u |
|
uid |
Der numerische Wert der Benutzer ID.
- Sofern die -o-Option nicht angegeben wird, muss dieser Wert einmalig sein.
- Er darf nicht negativ sein.
- Standardmäßig wird die kleinste ID verwendet, die größer als 999 und größer als jede andere Benutzer ID ist.
- Die Werte zwischen 0 und 999 werden typischerweise für Systemkonten reserviert.
- Dateien im Heimatverzeichnis des Benutzers, die dessen UID tragen, werden automatisch angepasst.
- Dateien außerhalb des Heimatverzeichnisses müssen manuell angepasst werden
|
-L |
|
|
Das Passwort des Benutzers blockieren (Zugang sperren)
Diese Option darf nicht zusammen mit -p oder -U angegeben werden
|
-U |
|
|
Passwort, dass mit -L blockiert wurde wieder freigeben
Diese Option darf nicht zusammen mit -p oder -L verwendet werden
|
- Achtung
- Wenn man die Option -G ohne die Option -a verwendet, so wird der entsprechende User den Gruppen hinzugefügt, welche als Liste übergeben werden, und aus allen anderen entfernt!
- Daher muss man, falls man den User einer Gruppe hinzufügen will, ohne die anderen Gruppenzugehörigkeiten anzutasten, die Optionen -a und -G immer zusammen verwenden, da man sich ansonsten z. B. auch aus der Gruppe admin entfernen könnte (die benötigt wird, um sich Root-Rechte verschaffen zu können)
Parameter
Umgebungsvariablen
Exit-Status
Konfiguration
The following configuration variables in /etc/login.defs change the behavior of this tool:
Dateien
/etc/group |
Group account information
|
/etc/gshadow |
Secure group account information
|
/etc/login.defs |
Shadow password suite configuration
|
/etc/passwd |
User account information
|
/etc/shadow |
Secure user account information
|
/etc/subgid |
Per user subordinate group IDs
|
/etc/subuid |
Per user subordinate user IDs
|
Anhang
Siehe auch
Dokumentation
Man-Page
chfn(1), chsh(1), passwd(1), crypt(3), gpasswd(8), groupadd(8), groupdel(8), groupmod(8), login.defs(5), subgid(5), subuid(5), useradd(8), userdel(8)
Info-Pages
Links
Projekt
Weblinks
TMP
USERMOD(8) System Management Commands USERMOD(8)