SnapCenter Windows disk management cmdlets
New-SmRole
Suggest changes
PDFs
Enables you to create a role, assign users, assign groups, and assign permissions.
Syntax
New-SmRole [-Name] <String> [-Description] <String> [-Permissions] <String> [-AssignedUsers] <String> [-AssignedGroups] <String> [-SharedObjects] <>
Detailed Description
Enables you to create a role, assign users, assign groups, and assign permissions.
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
Name |
Specifies the name of the new role. |
true |
true (ByPropertyName) |
|
Description |
Specifies an optional description of the role. |
false |
true (ByPropertyName) |
|
Permissions |
Specifies what permissions are assigned to the role. |
false |
true (ByPropertyName) |
|
AssignedUsers |
Specifies users assigned to the role. |
false |
true (ByPropertyName) |
|
AssignedGroups |
Specifies groups assigned to the role. |
false |
true (ByPropertyName) |
|
SharedObjects |
false |
true (ByPropertyName) |
Examples
Example 1: Creating a new role
New-SmRole -Name TestRole
This example syntax creates a new role with the specified name.
Description : Name: TestRole Type: Id : Host: UserName: Passphrase : Deleted : False Auth: SMCoreContracts.SmAuth IsClone : False CloneLevel : 0
Example 2: Creating a new role and assigning a user
New-SmRole -Name TestRoleWithUser -AssignedUsers sddev\snapdrive
This example syntax creates a new role and assigns the specified user.
Description : Name: TestRoleWithUser Type: Id : Host: UserName: Passphrase : Deleted : False Auth: SMCoreContracts.SmAuth IsClone : False CloneLevel : 0
Example 3: Creating a new role and assigning multiple users
New-SmRole -Name TestRoleWithUsers -AssignedUsers "sddev\administrator,sddev\snapdrive"
This example syntax creates a new role and assigns multiple users to the role.
Description : Name: TestRoleWithUsers Type: Id : Host: UserName: Passphrase : Deleted : False Auth: SMCoreContracts.SmAuth IsClone : False CloneLevel : 0
Example 4: Creating a new role and assigning a group
New-SmRole -Name TestRoleWithGroup -AssignedGroups sddev\administrators
This example syntax creates a new role and assigns the specified group to the role.
Description : Name: TestRoleWithGroup Type: Id : Host: UserName: Passphrase : Deleted : False Auth: SMCoreContracts.SmAuth IsClone : False CloneLevel : 0
Example 5: Creating a role and assigning multiple groups
New-SmRole -Name TestRoleWithGroups -AssignedGroups "sddev\administrators, sddev\Domain Admins"
This example syntax creates a new role and assigns multiple groups to the role.
Description : Name: TestRoleWithGroups Type: Id : Host: UserName: Passphrase : Deleted : False Auth: SMCoreContracts.SmAuth IsClone : False CloneLevel : 0
Example 6: Creating a new role and assigning permissions
New-SmRole -Name TestRoleWithGroups -AssignedGroups "sddev\administrators, sddev\Domain Admins"
This example syntax creates a new role and assigns the specified permissions the groups assigned to the role.
PS C:\> New-SmRole -Name TestRoleWithPermissions -Permissions "Host: read, update, delete, crea te; dataset: read, update, create, delete" Description : Name: TestRoleWithPermissions Type: Id : Host: UserName: Passphrase : Deleted : False Auth: SMCoreContracts.SmAuth IsClone : False CloneLevel : 0