Set-SCRunAsAccount

Set-SCRunAsAccount

Modifies the properties of a Run As account.

構文

Parameter Set: Default
Set-SCRunAsAccount [-RunAsAccount] <RunAsAccount> [-Credential <PSCredential> ] [-Description <String> ] [-JobGroup <Guid]> ] [-JobVariable <String> ] [-Name <String> ] [-NoValidation] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-Owner <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-UserRole <UserRole> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

詳細説明

The Set-SCRunAsAccount cmdlet modifies the properties of a Virtual Machine Manager (VMM) Run As account.

パラメーター

-Credential<PSCredential>

Specifies a credential object or, for some cmdlets, a Run As account object that contains the user name and password of an account that has permission to perform this action. Or, in the case of Restart-SCJob, has permission to complete a restarted task.

For more information about the PSCredential object, type Get-Help Get-Credential. For more information about Run As accounts, type Get-Help New-SCRunAsAccount.

-Description<String>

States a description for the specified object.

-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.

-JobVariable<String>

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

-Name<String>

Specifies the name of a VMM object.

-NoValidation

Indicates that the Run As account will not validate the provided domain credentials.

-OnBehalfOfUser<System.String>

For more information about the PSCredential object, type Get-Help Get-Credential. For more information about Run As accounts, type Get-Help New-SCRunAsAccount.

-OnBehalfOfUserRole<Microsoft.SystemCenter.VirtualMachineManager.UserRole>

For more information about the PSCredential object, type Get-Help Get-Credential. For more information about Run As accounts, type Get-Help New-SCRunAsAccount.

-Owner<String>

Specifies the owner of a VMM object in the form of a valid domain user account.

Example format: -Owner "Contoso\ReneeLo"

Example format: -Owner "ReneeLo@Contoso"

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

-RunAsAccount<RunAsAccount>

Specifies a Run As account that contains credentials with permission to perform this action.

-RunAsynchronously

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

-UserRole<UserRole>

Specifies a user role object.

-VMMServer<ServerConnection>

Specifies a VMM server object.

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• RunAsAccount

例

Example 1: Change the name of an existing Run As account

The first command gets the Run As account object named RunAsAccount01, and then stores the object in the $RunAsAccount variable.

The second command changes the name of the Run As account stored in $RunAsAccount to New Run As Account Name and adds a description for the account.

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Set-SCRunAsAccount -RunAsAccount $RunAsAccount -Name "New Run As Account Name" -Description "This is an administrator account for accessing Hyper-V hosts." 

関連トピック

Get-SCRunAsAccount

New-SCRunAsAccount

Restart-SCJob