Get-SCRunAsAccount

VMM 実行アカウントを取得します。

構文

Get-SCRunAsAccount
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [[-Name] <String>]
   [-IsEnabled <Boolean>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Get-SCRunAsAccount コマンドレットは、Virtual Machine Manager (VMM) 実行アカウントを取得します。

例 1: 実行アカウントを名前で取得する

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $RunAsAccount

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

2 番目のコマンドは、ユーザーに$RunAsAccountに格納されている実行アカウントに関する情報を表示します。

例 2: 有効な実行アカウントを名前で取得する

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "RunAsAccount01" -IsEnabled $True
PS C:\> $RunAsAccount

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

2 番目のコマンドは、ユーザーに$RunAsAccountに格納されている実行アカウントに関する情報を表示します。

例 3: 名前に指定した文字列を含む有効な実行アカウントを取得する

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name *Account* -IsEnabled $True
PS C:\> $RunAsAccount[0]
PS C:\> $RunAsAccount[1]

最初のコマンドは、名前に Account を含むすべての有効な実行アカウント オブジェクトを取得し、$RunAsAccount配列にオブジェクトを格納します。

2 番目のコマンドは、$RunAsAccount配列内の最初の実行アカウントに関する情報をユーザーに表示します。

3 番目のコマンドは、$RunAsAccount配列内の 2 番目の実行アカウントに関する情報をユーザーに表示します。

パラメーター

-ID

特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。

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

-IsEnabled

このコマンドレットが有効になっている実行アカウントを取得するかどうかを示します。 $Falseを指定した場合、コマンドレットは無効になっている実行アカウントを返します。

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

-Name

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

Type:String
Position:0
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

-VMMServer

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

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

出力

RunAsAccount

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