Skip to main content
SnapCenter 4.8 cmdlets

Set-SmRole

Contributors
PDFs

Creates a new role.

Syntax

Set-SmRole [-Name]  <String>  [-Description]  <String>  [-Permissions]  <String>  [-AssignedUsers]  <String>  [-AssignedGroups]  <String>  [-SharedObjects]  <>  [-DeleteSharedObjects]  <>

Detailed Description

Creates a new role name. Enables you to assign groups and users to the role, and to assign SnapCenter resource permissions.

Parameters

Name Description Required? Pipeline Input Default Value

Name

Specifies the name of the role you want to modify.

true

true (ByPropertyName)

Description

Describes the role you want to modify.

false

true (ByPropertyName)

Permissions

Specifies the permissions for the new role: Example: host:read,create,delete,update;dataset:create,update,dashboard,allowUse the format [<SnapCenter Resource Name>:<permission1 name>,<permission2 name>,…​];[<SnapCenter Resource Name>…​]Permission settings for multiple SnapCenter resource names must be separated by ";"The SnapCenter resource name is DataSet, Policy, Backup, Host, StorageConnection, Clone, Provision, DashBoard, Restore, Reports, Discovery, Plugin_Installation or Migration.The permission name is create, read, update, delete or allow.

false

true (ByPropertyName)

AssignedUsers

Specifies users to be assigned to the new role: Example: domain1\user1,domain2\user2

false

true (ByPropertyName)

AssignedGroups

Specifies groups to be assigned to the new role: Example: domain1\group1,domain2\group2

false

true (ByPropertyName)

SharedObjects

false

true (ByPropertyName)

DeleteSharedObjects

false

true (ByPropertyName)

Examples

Example 1: Creating a new role and assigning permissions, users, and groups

 set-smrole -Name PayrollAppAdmin -Description "Manage payroll backup operations" -Permissions "DashBoard:allow;DataSet:create,read,update,delete" -AssignedUsers "sddev\administrator" -AssignedGroups "mva\Administrators"

This example syntax creates a new role and assigns the specified permissions, users, and groups to the role.

Description : Manage payroll backup operations
Name: PayrollAppAdmin
Type:
Id  :
Host:
UserName:
Passphrase  :
Deleted : False
Auth: SMCoreContracts.SmAuth
IsClone : False
CloneLevel  : 0