New-SCUserRole

  • リファレンス
モジュール:
VirtualMachineManager

VMM ユーザーのグループのユーザー ロールを作成します。

構文

New-SCUserRole
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   -UserRoleProfile <Profile>
   [-ID <Guid>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-ParentUserRole <UserRole>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

New-SCUserRole コマンドレットは、Virtual Machine Manager (VMM) ユーザーのグループのユーザー ロールを作成します。 次のユーザー ロールを作成できます。委任された管理者、Read-Only管理者、仮想マシン管理者、Self-Service ユーザーです。 管理者ロールは 1 つだけ存在します。 別の管理者ロールを作成したり、既存の管理者ロールを削除したりすることはできません。

委任された管理者ユーザー ロールのメンバーである場合は、ユーザー ロールを作成できます。 ただし、新しいユーザー ロールのスコープは、その親ユーザー ロールのスコープのサブセットである必要があります。

ユーザー ロールを作成した後、 Set-SCUserRole コマンドレットを使用してユーザー ロールの名前を変更したり、メンバーを追加または削除したり、ロールのメンバーが管理できるオブジェクトのスコープを追加または変更することができます。 Self-Service ユーザー ロールの場合、Self-Service ユーザー ロールのメンバーが仮想マシンに対して実行できるアクションを指定できます。また、セルフサービス ユーザーが作成できる仮想マシンの数を制限するクォータを定義できます。 管理者ロールを作成または削除したり、そのスコープを制限したりすることはできませんが、 Set-SCUserRole を使用してそのロールに対するメンバーを追加または削除できます。

ユーザー ロールのプロパティを変更する方法については、「 Get-Help Set-SCUserRole.

例

例 1: 委任された管理者ユーザー ロールを作成する

PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"

このコマンドは、ContosoDelegatedAdmin という名前の代理管理者ユーザー ロールを作成し、Contoso.com ドメインの代理管理者の説明を提供し、 UserRoleProfile パラメーターを使用して、ユーザー ロールの種類を委任された管理者として指定します。

例 2: セルフサービス ユーザー ロールを作成する

PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"

このコマンドは、ContosoSelfServiceUsers という名前の新しいユーザー ロールを作成し、 UserRoleProfile パラメーターを使用して新しいユーザー ロールの種類Self-Serviceユーザーとして指定し、新しいユーザー ロール オブジェクトを $SelfServiceRole 変数に格納します。

例 3: 仮想マシン管理者ロールを作成する

PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"

このコマンドは、 VirtualMachineAdmin という名前の仮想マシン管理者ユーザー ロールを作成し、"contoso.com ドメインの仮想マシン管理者" という説明を提供し、UserRoleProfile パラメーターを使用してユーザー ロールの種類を VMAdmin として指定します。

パラメーター

-Description

ユーザー ロールの説明を指定します。

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

-ID

新しいユーザー ロールの一意の ID を指定します。

Type:Guid
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

新しいユーザー ロールの名前を指定します。

Type:String
Position:0
Default value:None
Required:True
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

-ParentUserRole

既存の VMM ユーザー ロールを新しいユーザー ロールの親として指定します。

Type:UserRole
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

-RunAsynchronously

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

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

-UserRoleProfile

新しいユーザー ロールの基礎となるプロファイルの種類を指定します。 このパラメーターの有効値は、次のとおりです。

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
  • TenantAdmin
  • VMAdmin
Type:Profile
Accepted values:Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:True
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

出力

UserRole

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