Skip to content

Windows Server 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
- windows_server.users.add_to_group:
    user_name: example.user
    group_name: example.group
  load:
    windows_server: windows_server
Adding a Domain User
1
2
3
4
5
- windows_server.users.add_to_group:
    user_name: domain\example.user
    group_name: example.group
  load:
    windows_server: windows_server

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 to true)

  • description: an optional description for the user

  • password_never_expires: set to true to prevent the user's password expiring (defaults to false)

Output

Nothing is outputted by this action.

Example
1
2
3
4
5
6
7
- windows_server.users.create:
    name: example.user
    full_name: Example User
    description: Create by PPA
  load:
    password: new_password
    windows_server: windows_server

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.delete:
    name: example.user
  load:
    windows_server: windows_server

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.disable:
    name: example.user
  load:
    windows_server: windows_server

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.get_all:
  load:
    windows_server: windows_server
  save: all_users

- windows_server.users.display:
    text: All Local Users
  load:
    users: all_users

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
- set:
    name: tabs
    value: {}

- windows_server.users.get_all:
  load:
    windows_server: windows_server
  save: all_users

- ppa_tools.dictionaries.insert:
    name: My Server
  load:
    value: all_users
    dictionary: tabs
  save: tabs

- windows_server.users.display_tabbed:
    text: All Local Users
  load:
    tabs: tabs

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.enable:
    name: example.user
  load:
    windows_server: windows_server

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
Output

A list of User dictionaries.

Example
1
2
3
4
- windows_server.users.get_all:
  load:
    windows_server: windows_server
  save: all_users

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
- windows_server.users.remove_from_group:
    user_name: example.user
    group_name: example.group
  load:
    windows_server: windows_server
Removing a Domain User
1
2
3
4
5
- windows_server.users.remove_from_group:
    user_name: domain\example.user
    group_name: example.group
  load:
    windows_server: windows_server

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:

  • total: the number of selected Users

  • all: a list of selected Users

  • first: the first selected User

Example
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
- windows_server.users.get_all:
  load:
    windows_server: windows_server
  save: users

- windows_server.users.select:
    text: Select Users
  load:
    users: users
  save: selection

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.get_all:
  load:
    windows_server: windows_server
  save: users

- windows_server.users.select_one:
    text: Select a User
  load:
    users: users
  save: user

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
- windows_server.users.set_password:
    name: example.user
  load:
    password: new_password
    windows_server: windows_server