Gets one or more top-level or child view groups as seen in XProtect Smart Client.
View groups are containers for groups and views. Top-level view groups are defined in Management Client and permissions can be set per role for these top-level groups.
In XProtect Smart Client, you will normally see a "Private" view group which is unique to your user account, and zero or more additional view groups depending on your system configuration. These view groups cannot directly contain views, but they can contain one or more child view groups. Views and view groups can be nested.
Use this command to retrieve view groups and inspect or modify their contents,
or adjust permissions for roles using the
- Requires VMS connection and will attempt to connect automatically
- Requires VMS version 21.1
Connect-ManagementServer -ShowDialog -AcceptEula Get-VmsViewGroup <# OUTPUT DisplayName Id LastModified ----------- -- ------------ Private 5C72A7B2-E3A8-4FF1-9F97-85C99D91E9D1 10/5/2017 5:21:01 PM Main View Group 95DA86DD-386D-4159-87D8-00885CE29407 10/22/2017 9:38:44 PM LPR B3E356AF-1F4A-4557-A8D5-CAE7641384D6 10/19/2018 11:03:10 PM #>
After ensuring there is an open connection to the Management Server, we retrieve a list of all view groups.
In this example you will be prompted to select from one of the top-level view groups, and then all child view groups, recursively, will be returned.
In this example, we recursively seek all view groups inside the top-level 'Main View Group` group, and then return all views in all child view groups.
Specifies the ID of a specific view group. It can be a top-level, or child view group.
Specifies the view group name with support for wildcards.
Specifies a parent view group object. Useful for retrieving child view groups from a specific parent view group.
Specifies that all child view groups should be returned recursively.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.