ts user

Show and manage a user account.

Usage

ts users [<filter>] [-n N]
ts user <login>
ts user new <login> [--first-name=NAME] [--last-name=NAME] [--directory=PREFIX]
ts user delete <login> [--force]
ts user restore <login>

Description

ts users lists accounts, newest first. Pass a filter to narrow it — matched against login name, first name, and last name — and -n to change how many come back.

ts user <login> shows one account: its display name, whether it is enabled, which groups it belongs to, and when it was created.

ts user new creates a local account. --directory instead creates a reference to an account in a directory service, using that service's login prefix; the password and profile stay in the directory, and Turbo Server records only the association.

ts user delete is a soft delete. The account stops working and disappears from listings, but its history — sessions, usage, audit entries — stays intact and attributed. ts user restore brings it back. This is why deleting a user is safe to do promptly when someone leaves: nothing about what they did is lost.

Creating, deleting, and restoring accounts are all recorded in the audit log.

Options

Flag	Description	Default/Values	Notes
--first-name	First name for a new account.		new only.
--last-name	Last name for a new account.		new only.
--directory	Directory-service login prefix.		new only; makes this a directory account rather than a local one.
--force, -f	Delete without confirming.		delete only.
-n, --number	Maximum results.		ts users only.

Examples

# Everyone
ts users

# Find someone
ts users smith

# What is this account, and what can it reach?
ts user jsmith

# A new local account
ts user new contractor1 --first-name=Sam --last-name=Rivera

# An account backed by the corporate directory
ts user new rlee --directory=corp

# Someone left
ts user delete jsmith --force

# Someone came back
ts user restore jsmith

Output

USERNAME  FIRST NAME  LAST NAME  ENABLED  ID
admin     admin                  yes      5b3b91f5-7ff6-4615-b8b3-a26e30d03c16
jsmith    Jamie       Smith      yes      c41f0d8a-2b77-4c19-9e0a-1d3b6f2e5a90

Exit Codes

0 on success. -4 when no account is signed in. -5 when the account is not a Server Administrator. -6 when the login does not exist.

Related Commands

• ts group — Group membership, which is how permissions are granted.
• ts directory-service — The directories --directory refers to.