Add-SCUserRolePermission

Add-SCUserRolePermission

Adds a permission to a user role.

Syntax

Parameter Set: JobGroup
Add-SCUserRolePermission -JobGroup <Guid]> [-AllowLocalAdmin] [-Author] [-AuthorVMNetwork] [-CanReceive] [-CanShare] [-Checkpoint] [-CheckpointRestoreOnly] [-Cloud <Cloud> ] [-Deploy] [-DeployFromTemplateOnly] [-JobVariable <String> ] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-PauseAndResume] [-PROTipID <Guid]> ] [-RemoteConnect] [-Remove] [-RunAsynchronously] [-Save] [-Shutdown] [-Start] [-Stop] [-Store] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: UserRole
Add-SCUserRolePermission -UserRole <SelfServiceUserRole> [-AllowLocalAdmin] [-Author] [-AuthorVMNetwork] [-CanReceive] [-CanShare] [-Checkpoint] [-CheckpointRestoreOnly] [-Deploy] [-DeployFromTemplateOnly] [-JobVariable <String> ] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-PauseAndResume] [-PROTipID <Guid]> ] [-RemoteConnect] [-Remove] [-RunAsynchronously] [-Save] [-Shutdown] [-Start] [-Stop] [-Store] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: UserRolePermission
Add-SCUserRolePermission -UserRolePermission <UserRolePermission> [-AllowLocalAdmin] [-Checkpoint] [-CheckpointRestoreOnly] [-Deploy] [-DeployFromTemplateOnly] [-JobVariable <String> ] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-PauseAndResume] [-PROTipID <Guid]> ] [-RemoteConnect] [-Remove] [-RunAsynchronously] [-Save] [-Shutdown] [-Start] [-Stop] [-Store] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: Values
Add-SCUserRolePermission -Cloud <Cloud> -UserRole <SelfServiceUserRole> [-AllowLocalAdmin] [-Checkpoint] [-CheckpointRestoreOnly] [-Deploy] [-DeployFromTemplateOnly] [-JobVariable <String> ] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-PauseAndResume] [-PROTipID <Guid]> ] [-RemoteConnect] [-Remove] [-RunAsynchronously] [-Save] [-Shutdown] [-Start] [-Stop] [-Store] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The Add-SCUserRolePermission cmdlet adds a permission to a user role.

Parameters

-AllowLocalAdmin

Indicates that this cmdlet adds the Allow Local Admin permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Author

Indicates that this cmdlet adds the Author permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AuthorVMNetwork

Indicates that this cmdlet adds the Author VMNetwork permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CanReceive

Indicates that this cmdlet adds the Can Receive permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CanShare

Indicates that this cmdlet adds the Can Share permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Checkpoint

Indicates that this cmdlet adds the Can Checkpoint permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CheckpointRestoreOnly

Indicates that this cmdlet adds the Can Checkpoint Restore Only permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Cloud<Cloud>

Specifies a private cloud object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Deploy

Indicates that this cmdlet adds the Deploy virtual machine permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DeployFromTemplateOnly

Indicates that this cmdlet adds the Deploy From Template Only virtual machine permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobGroup<Guid]>

Specifies an identifier for a series of commands that will run as a set just before the final command that includes the same job group identifier runs.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OnBehalfOfUser<System.String>

Specifies a user name. This cmdlet operates on behalf of the user that this parameter specifies.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OnBehalfOfUserRole<Microsoft.SystemCenter.VirtualMachineManager.UserRole>

Specifies a user role. To obtain a user role, use the Get-SCUserRole cmdlet. This cmdlet operates on behalf of the user role that this parameter specifies.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PauseAndResume

Indicates that this cmdlet adds the Can Pause And Resume permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PROTipID<Guid]>

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RemoteConnect

Indicates that this cmdlet adds the Remote Connect permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Remove

Indicates that this cmdlet adds the Can Remove permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsynchronously

Indicates that this cmdlet adds that the job runs asynchronously so that control returns to the command shell immediately.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Save

Indicates that this cmdlet adds the Can Save VM permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Shutdown

Indicates that a virtual machine, service, or a source server should be shut down. In the case of a virtual machine or service, the associated cmdlet attempts to use the operating system to shut the virtual machine down gracefully. In the case of a successful physical-to-virtual machine (P2V) conversion, the cmdlet shuts down the source server.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Start

Indicates that this cmdlet adds the Can Start virtual machine permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Stop

Indicates that this cmdlet adds the Can Stop virtual machine permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Store

Indicates that this cmdlet adds the Can Store virtual machine permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UserRole<SelfServiceUserRole>

Indicates that this cmdlet adds a user role object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-UserRolePermission<UserRolePermission>

Specifies a UserRolePermission object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a Virtual Machine Manager (VMM) server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • UserRole

Get-SCUserRole

Get-SCUserRolePermission

Remove-SCUserRolePermission