Windows Server Windows Server: Group

Summary

This module contains actions for viewing & managing local groups on a Windows Server.

Actions

windows_server.groups.

get_all

Get all local groups from a Windows Server.

Minimum Plugin Version: 2.0.0

Domain Controllers

Running this action against a Domain Controller will return an empty list.

Input
Output

A list of Group dictionaries.

Example
1
2
3
4
- windows_server.groups.get_all:
  load:
    windows_server: windows_server
  save: all_groups

windows_server.groups.

get_users

Get all local users from a local group on a Windows Server.

Minimum Plugin Version: 2.0.0

Domain Controllers

Running this action against a Domain Controller will return an empty list.

Performance

This action uses WMI to get group members in an effort to avoid this bug.

It may take a few seconds on servers with many users & groups, or servers joined to a domain.

Input
  • windows_server: a WindowsServer dictionary

  • group_name: the name of the group

Output

A list of User dictionaries.

Example
1
2
3
4
5
- windows_server.groups.get_users:
    group_name: Remote Desktop Users
  load:
    windows_server: windows_server
  save: remote_desktop_users

windows_server.groups.

output_tabbed_table

Display a groups table with multiple tabs.

This action can be used to display group lists from multiple servers.

The table will have the following columns:

  • Name
  • Description

Minimum Plugin Version: 1.7.0

Input
  • text: the title of the table

  • tabs: a dictionary where each key is a tab name & each value is a list of Group dictionaries

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: tabbed_table
    value: {}

- windows_server.groups.get_all:
  load:
    windows_server: windows_server
  save: all_groups

- ppa_tools.dictionaries.insert:
    name: My Server
  load:
    value: all_groups
    dictionary: tabbed_table
  save: tabbed_table

- windows_server.groups.output_tabbed_table:
    text: All Local Groups
  load:
    tabs: tabbed_table

windows_server.groups.

output_table

Display groups in a table.

The table will have the following columns:

  • Name
  • Description

Minimum Plugin Version: 1.7.0

Input
  • text: the title of the table

  • groups: a list of Group dictionaries to display in the table

Output

Nothing is outputted by this action.

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

- windows_server.groups.output_table:
    text: All Local Groups
  load:
    groups: all_groups