Gets one or more of the roles already configured in the VMS.
Get-VmsRole cmdlet gets roles configured in the VMS. Users and groups can
be a member of one or more roles, and permissions are granted (or denied) to a
Permissions for a role are divided into two categories: overall security, and item-level security. For example, a role can be granted "Allow" for "GENERIC_READ", "VIEW_LIVE", and "PLAYBACK" for all cameras using overall security. Alternatively, a role can be granted those permissions for only a select set of cameras.
Permissions can be mixed as well. For example, if you want all members of a role to have permission to view live video from all cameras, you can set "GENERIC_READ" and "VIEW_LIVE" to "Allow" under overall security, and then grant playback permission to a subset of cameras.
- Requires VMS connection and will attempt to connect automatically
Gets all roles defined in the VMS, including the default Administrators role.
Gets the role named "Operators" if it exists, or returns an error if the role could not be found.
Gets all user-defined roles. This is useful when checking/changing permissions for many roles since it is invalid to change permissions for the Administrator role.
[guid] of an existing role.
Specifies the name of a role with support for wildcards.
Specifies the type of role to return: Administrative, or UserDefined. Please note that the typo on "Adminstrative" intentionally matches the typo for the RoleType property in MIP SDK.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.