user_present

Ensure a user exists on the system.

⚙️ Compatible targets: Linux, Windows

Parameters

NameDocumentation
loginUser login.

This parameter is required.

Outcome conditions

You need to replace ${login} with its actual canonified value.

  • ✅ Ok: user_present_${login}_ok
    • ☑️ Already compliant: user_present_${login}_kept
    • 🟨 Repaired: user_present_${login}_repaired
  • ❌ Error: user_present_${login}_error

Example

method: user_present
params:
  login: VALUE

Documentation

This method does not create the user's home directory. Primary group will be created and set with default one, following the useradd default behavior. As in most UNIX system default behavior user creation will fail if a group with the user name already exists.