Set-SCRunAsAccount

実行アカウントのプロパティを変更します。

構文

Set-SCRunAsAccount
   [-VMMServer <ServerConnection>]
   [-Name <String>]
   [-Description <String>]
   [-Credential <PSCredential>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-RunAsAccount] <RunAsAccount>
   [-JobGroup <Guid>]
   [-NoValidation]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Set-SCRunAsAccount コマンドレットは、仮想マシン マネージャー (VMM) 実行アカウントのプロパティを変更します。

例 1: 既存の実行アカウントの名前を変更する

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

最初のコマンドは、RunAsAccount01 という名前の実行アカウント オブジェクトを取得し、$RunAsAccount変数にオブジェクトを格納します。

2 番目のコマンドは、$RunAsAccountに格納されている実行アカウントの名前を "新しい実行アカウント名" に変更し、アカウントの説明を追加します。

パラメーター

-Credential

資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、 Restart-SCJob の場合は、再起動されたタスクを完了するためのアクセス許可を持ちます。

PSCredential オブジェクトの詳細については、「Get-Help Get-Credential.

実行アカウントの詳細については、「.」と入力します Get-Help New-SCRunAsAccount

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Description

実行アカウントの説明を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に一括して実行される、一連のコマンドの識別子を指定します。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

VMM オブジェクトの名前を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoValidation

実行アカウントで指定されたドメイン資格情報が検証されないことを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。

  • 形式の例: -Owner "Contoso\PattiFuller"
  • 形式の例: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsAccount

このアクションを実行するアクセス許可を持つ資格情報を含む実行アカウントを指定します。

Type:RunAsAccount
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

ユーザー ロール オブジェクトを指定します。

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

VMM サーバー オブジェクトを指定します。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

出力

RunAsAccount

このコマンドレットは RunAsAccount オブジェクトを 返します。