Creates a new role on the connected VMS.
New-VmsRole [-Name] <String> [[-Description] <String>] [-AllowSmartClientLogOn] [-AllowMobileClientLogOn] [-AllowWebClientLogOn] [-DualAuthorizationRequired] [-MakeUsersAnonymousDuringPTZSession] [[-ClientLogOnTimeProfile] <TimeProfile>] [[-DefaultTimeProfile] <TimeProfile>] [[-ClientProfile] <ClientProfile>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Creates a new role on the connected VMS. Permissions are associated with roles, and roles can have any number of users and groups, or "members".
- Requires VMS connection and will attempt to connect automatically
Prompts the user to login to a management server, then creates a new role named "My new role" with permission to logon to the mobile client, smart client, and web client. Note that the role does not yet have any members, and it has not been assigned permissions to any cameras.
Allow members of this role to logon using a mobile client.
Allow members of this role to logon using Smart Client.
Allow members of this role to logon using a web browser.
Specifies the time profile within which members of this role are allowed to logon.
Specifies which smart client profile to use with the new role. Use
to retrieve smart client profile objects, or enter the client profile by name.
Specifies the default time profile to use for permissions such as when members are allowed to play back recordings.
Specifies an optional description for the role.
Specifies that dual authorization is required for members of the role.
Specifies that PTZ operations should not be attributed to a specific user for members of the role.
Specifies a name for the new role.
Specifies that the new role should be returned to the caller. Normal behavior for a "New-*" cmdlet is to return the new item by default. However, when creating a large number of roles, the added time to make an extra API call to retrieve the new role, or to enumerate through the cached role collection to find it may not be preferred.
Prompts you for confirmation before running the cmdlet.
Shows what would happen if the cmdlet runs. The cmdlet is not run.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.