Windows Server: Users
Summary
This module contains actions for auditing local users on a Windows Server.
Actions
windows_server.users.
add_to_group
Add a local or domain user to a group on a Windows Server.
Minimum Plugin Version: 7.0.0
Domain Controllers
This action will fail if run against a Domain Controller.
Input
-
windows_server: a WindowsServer dictionary
-
user_name: the name of a local user, or domain\username for a domain user
-
group_name: the name of the group to add them to
Output
Nothing is outputted by this action.
Adding a Local User
1 2 3 4 5 |
|
Adding a Domain User
1 2 3 4 5 |
|
windows_server.users.
create
Create a user on a Windows Server.
Minimum Plugin Version: 7.0.0
Domain Controllers
This action will fail if run against a Domain Controller.
Input
-
windows_server: a WindowsServer dictionary
-
name: the username
-
full_name: new user's full name
-
password: a password for the user
-
enabled: set to
false
to create the user in a disabled state (defaults totrue
) -
description: an optional description for the user
-
password_never_expires: set to
true
to prevent the user's password expiring (defaults tofalse
)
Output
Nothing is outputted by this action.
Example
1 2 3 4 5 6 7 |
|
windows_server.users.
delete
Delete a user on a Windows Server.
Minimum Plugin Version: 7.0.0
Domain Controllers
This action will fail if run against a Domain Controller.
Input
-
windows_server: a WindowsServer dictionary
-
name: username of the user to delete
Output
Nothing is outputted by this action.
Example
1 2 3 4 |
|
windows_server.users.
disable
Disable a user on a Windows Server.
Minimum Plugin Version: 7.0.0
Domain Controllers
This action will fail if run against a Domain Controller.
Input
-
windows_server: a WindowsServer dictionary
-
name: username of the user to disable
Output
Nothing is outputted by this action.
Example
1 2 3 4 |
|
windows_server.users.
display
Display users in a table.
The table will have the following columns:
- Name
- Full Name
- Description
- Disabled
- Locked
Minimum Plugin Version: 3.0.0
Input
-
text: the title of the table
-
users: any number of Users
Output
Nothing is outputted by this action.
Example
1 2 3 4 5 6 7 8 9 |
|
windows_server.users.
display_tabbed
Display users in a table with multiple tabs.
This action can be used to display user lists from multiple servers.
The table will have the following columns:
- Name
- Full Name
- Description
- Disabled
- Locked
Minimum Plugin Version: 3.0.0
Input
-
text: the title of the table
-
tabs: a dictionary where each key is a tab name & each value is any number of Users
Output
Nothing is outputted by this action.
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
|
windows_server.users.
enable
Enable a user on a Windows Server.
Minimum Plugin Version: 7.0.0
Domain Controllers
This action will fail if run against a Domain Controller.
Input
-
windows_server: a WindowsServer dictionary
-
name: username of the user to enable
Output
Nothing is outputted by this action.
Example
1 2 3 4 |
|
windows_server.users.
get_all
Get all local users from a Windows Server.
Minimum Plugin Version: 2.0.0
Domain Controllers
This action will fail if run against a Domain Controller.
Input
- windows_server: a WindowsServer dictionary
Output
A list of User dictionaries.
Example
1 2 3 4 |
|
windows_server.users.
remove_from_group
Remove a local or domain user from a group on a Windows Server.
Minimum Plugin Version: 7.0.0
Domain Controllers
This action will fail if run against a Domain Controller.
Input
-
windows_server: a WindowsServer dictionary
-
user_name: the name of a local user, or domain\username for a domain user
-
group_name: the name of the group to remove them from
Output
Nothing is outputted by this action.
Removing a Local User
1 2 3 4 5 |
|
Removing a Domain User
1 2 3 4 5 |
|
windows_server.users.
select
Display users in a table & prompt the task operator to make a selection.
The table will have the following columns:
- Name
- Full Name
- Description
- Disabled
- Locked
Minimum Plugin Version: 3.0.0
Input
-
text: the title of the table
-
users: any number of Users
-
minimum: the minimum number of selections
-
maximum: the maximum number of selections
Output
A Selection containing:
Example
1 2 3 4 5 6 7 8 9 10 |
|
windows_server.users.
select_one
Display users in a table & prompt the task operator to select one.
The table will have the following columns:
- Name
- Full Name
- Description
- Disabled
- Locked
Minimum Plugin Version: 3.0.0
Input
-
text: the title of the table
-
users: any number of Users
Output
A single User.
Example
1 2 3 4 5 6 7 8 9 10 |
|
windows_server.users.
set_password
Set a password for a user on a Windows Server.
Minimum Plugin Version: 7.0.0
Domain Controllers
This action will fail if run against a Domain Controller.
Input
-
windows_server: a WindowsServer dictionary
-
name: username of the user to enable
-
password: a new password to set
Output
Nothing is outputted by this action.
Example
1 2 3 4 5 |
|