123 lines
3.1 KiB
ReStructuredText
123 lines
3.1 KiB
ReStructuredText
.. _user:
|
|
|
|
user
|
|
``````````````````````````````
|
|
|
|
.. versionadded:: 0.2
|
|
|
|
Manage user accounts and user attributes.
|
|
|
|
.. raw:: html
|
|
|
|
<table>
|
|
<tr>
|
|
<th class="head">parameter</th>
|
|
<th class="head">required</th>
|
|
<th class="head">default</th>
|
|
<th class="head">choices</th>
|
|
<th class="head">comments</th>
|
|
</tr>
|
|
<tr>
|
|
<td>comment</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Optionally sets the description (aka <em>GECOS</em>) of user account.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>shell</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Optionally set the user's shell.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>force</td>
|
|
<td>no</td>
|
|
<td>no</td>
|
|
<td><ul><li>True</li><li>False</li></ul></td>
|
|
<td>When used with <em>state=absent</em>, behavior is as with <em>userdel --force</em>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>name</td>
|
|
<td>yes</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Name of the user to create, remove or modify.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>createhome</td>
|
|
<td>no</td>
|
|
<td>yes</td>
|
|
<td><ul><li>True</li><li>False</li></ul></td>
|
|
<td>Unless set to <em>no</em>, a home directory will be made for the user when the account is created.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>system</td>
|
|
<td>no</td>
|
|
<td>no</td>
|
|
<td><ul><li>True</li><li>False</li></ul></td>
|
|
<td>When creating an account, setting this to <em>yes</em> makes the user a system account. This setting cannot be changed on existing users.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>remove</td>
|
|
<td>no</td>
|
|
<td>no</td>
|
|
<td><ul><li>True</li><li>False</li></ul></td>
|
|
<td>When used with <em>state=absent</em>, behavior is as with <em>userdel --remove</em>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>state</td>
|
|
<td>no</td>
|
|
<td>present</td>
|
|
<td><ul><li>present</li><li>absent</li></ul></td>
|
|
<td>Whether the account should exist. When <em>absent</em>, removes the user account.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>groups</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Puts the user in this comma-delimited list of groups.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>home</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Optionally set the user's home directory.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>group</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Optionally sets the user's primary group (takes a group name).</td>
|
|
</tr>
|
|
<tr>
|
|
<td>password</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Optionally set the user's password to this crypted value. See the user example in the github examples directory for what this looks like in a playbook.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>append</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>If <em>yes</em>, will only add groups, not set them to just the list in <em>groups</em>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>uid</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Optionally sets the <em>UID</em> of the user.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
.. raw:: html
|
|
|
|
<br/>
|
|
|