Set-SCUserRole

リファレンス

モジュール:: VirtualMachineManager

既存の VMM ユーザーロールの設定を変更します。

構文

Set-SCUserRole
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-AddMember <String[]>]
   [-RemoveMember <String[]>]
   [-Permission <SelfServicePermission[]>]
   [-UserRoleDataPath <String>]
   [-RemoveLibraryStoreSharePath]
   [-ShowPROTips <Boolean>]
   [-AddScope <ClientObject[]>]
   [-RemoveScope <ClientObject[]>]
   [-Description <String>]
   [-VMNetworkMaximum <UInt16>]
   [-VMNetworkMaximumPerUser <UInt16>]
   [-RemoveVMNetworkMaximum]
   [-RemoveVMNetworkMaximumPerUser]
   [-VPNConnectionMaximum <UInt16>]
   [-VPNConnectionMaximumPerUser <UInt16>]
   [-RemoveVPNConnectionMaximum]
   [-RemoveVPNConnectionMaximumPerUser]
   [-NATConnectionMaximum <UInt16>]
   [-NATConnectionMaximumPerUser <UInt16>]
   [-RemoveNATConnectionMaximum]
   [-RemoveNATConnectionMaximumPerUser]
   [-VMNetworkVPNMaximumBandwidthInKbps <UInt64>]
   [-VMNetworkVPNMaximumBandwidthOutKbps <UInt64>]
   [-RemoveVMNetworkVPNMaximumBandwidthIn]
   [-RemoveVMNetworkVPNMaximumBandwidthOut]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Set-SCUserRole コマンドレットは、既存の Virtual Machine Manager (VMM) ユーザーロールの設定を変更します。変更できる設定は、VMM ユーザーロールの種類によって異なります。

ユーザーロールの種類は次のとおりです。

VMM 管理者 (管理者)

管理者ユーザーロールにメンバーを追加したり、管理者ユーザーロールからメンバーを削除したりすることができます。このロールのメンバーが管理できるオブジェクトのスコープを制限することはできません。

委任された管理者 (DelegatedAdmin)

委任された管理者ユーザーロールにメンバーを追加したり、メンバーを削除したりできます。委任された管理者ユーザーロールのスコープを拡張または制限できます。このユーザーロールのメンバーに、プライベートクラウドおよびホストグループ内のすべてのオブジェクトを管理するためのアクセス許可を付与できます。ユーザーがライブラリサーバーに格納されているすべてのオブジェクトの管理を許可できます。そのフレームワーク内では、委任された管理者ユーザーロールのメンバーが実行できるアクションを制限することはできません。

Read-Only 管理者 (ReadOnlyAdmin)

Read-Only 管理者ユーザーロールにメンバーを追加したり、メンバーを削除したりすることができます。 Read-Only 管理者ユーザーロールのスコープを拡張または制限できます。ただし、ユーザーロールのメンバーは、割り当てられたスコープ内のオブジェクトのプロパティ、状態、およびジョブの状態のみを表示できます。どのオブジェクトも変更できません。

Self-Service ユーザー (SelfServiceUser)

Self-Service ユーザーロールにメンバーを追加したり、メンバーを削除したりすることができます。 Self-Service ユーザーロールのメンバーのスコープとアクションを拡張または制限できます。 Self-Service ユーザーロールのメンバーに、プライベートクラウド内のすべてのオブジェクトを管理するためのアクセス許可を付与できます。仮想マシンを作成するアクセス許可、仮想マシンが存在するクラウドに格納されている仮想マシンパスに仮想マシンを格納するアクセス許可、テンプレートオブジェクトを使用して仮想マシンを作成するアクセス許可を付与できます。そのフレームワーク内では、セルフサービスユーザーが実行できる Self-Service ユーザーロールアクションのメンバーに付与できます。また、セルフサービスユーザーが作成できる仮想マシンの数を制限することもできます。そのためには、各ユーザーまたはすべてのユーザーにまとめて適用されるクォータを設定します。

セルフサービスユーザーに付与できるアクションには、次のようなものがあります。

AllowLocalAdmin。仮想マシンに対するユーザーのローカル管理者権限を付与します。
著者。仮想マシンとサービステンプレートを作成します。
CanShare。他の Self-Service ユーザーとリソースを共有します。
CanReceive。他の Self-Service ユーザーからリソースを受信します。
チェックポイント。仮想マシンのチェックポイントを作成および管理します。
CheckpointRestoreOnly。チェックポイントのみを復元できます。
創造する。テンプレートからのみ仮想マシンとサービスを作成します。
CreateFromVHDOrTemplate。仮想ハードディスク (VHD) ファイルまたはテンプレートから仮想マシンとサービスを作成します。
PauseAndResume。仮想マシンとサービスを一時停止して再開します。
RemoteConnect。仮想マシンにリモート接続します。
取り去る。仮想マシンとサービスを削除します。
セーブ。仮想マシンとサービスを保存します。
シャットダウン。仮想マシンをシャットダウンします。
始める。仮想マシンとサービスを起動します。
止める。仮想マシンとサービスを停止します。
店。仮想マシンをライブラリに格納します。

例

例 1: VMM 管理者ユーザーロールにユーザーを追加する

PS C:\> $UserRole = Get-SCUserRole -Name "Administrator"
PS C:\> Set-SCUserRole -UserRole $UserRole -AddMember "Contoso\User01","Contoso\User02"

最初のコマンドは、Administrator という名前のユーザーロールオブジェクトを取得し、そのオブジェクトを $UserRole 変数に格納します。

2 番目のコマンドは、User01 と User02 を管理者ユーザーロールに追加します。どちらのユーザーも、Contoso.com ドメインのメンバーです。

例 2: パイプラインを使用して管理者ロールにユーザーを追加する

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" | where { $_.Profile -eq "Administrator" } | Set-SCUserRole -AddMember "Contoso\User03"

このコマンドは、VMMServer01 からすべてのユーザーロールオブジェクトを取得し、プロファイルが Administrator であるユーザーロールオブジェクトを選択し、User03 を管理者ユーザーロールに追加します。

例 3: クラウドをスコープに追加して、既存の Self-Service ユーザーロールを変更する

PS C:\> $Cloud = Get-SCCloud -Name "Cloud02"
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCUserRole -UserRole $UserRole -AddScope $Cloud

最初のコマンドは Cloud02 という名前のクラウドオブジェクトを取得し、そのオブジェクトを $Cloud 変数に格納します。

2 番目のコマンドは、ContosoSelfServiceUsers という名前のユーザーロールオブジェクトを取得し、そのオブジェクトを$UserRole プロファイルに格納します。

最後のコマンドは、$Cloudに格納されているクラウドをそのスコープに追加することで、$UserRoleに格納されているユーザーロールのスコープを変更します。

例 4: 管理者ユーザーロールから指定したユーザーを削除する

PS C:\> $UserRole = Get-SCUserRole -Name "Administrator"
PS C:\> Set-SCUserRole -UserRole $UserRole -RemoveMember "Contoso\User01"

最初のコマンドは、Administrator という名前のユーザーロールオブジェクトを取得し、そのオブジェクトを $UserRole 変数に格納します。

2 番目のコマンドは、管理者ユーザーロールから User01 を削除します。 User01 は、Contoso.com ドメインのメンバーです。

例 5: Self-Service ユーザーロールのスコープにクラウドを追加する

PS C:\> $Cloud = Get-SCCloud -Name "Cloud03"
PS C:\> Get-SCUserRole -Name "ContosoSelfServiceUsers" | Set-SCUserRole -AddScope $Cloud

最初のコマンドは Cloud03 という名前のクラウドオブジェクトを取得し、そのオブジェクトを $Cloud 変数に格納します。

2 番目のコマンドは、ContosoSelfServiceUsers という名前のユーザーロールオブジェクトを取得し、そのユーザーロールオブジェクトを現在のコマンドレットに渡します。このコマンドレットは、$Cloudに格納されているクラウドをユーザーロールに追加します。

例 6: Self-Service ユーザーロールのメンバーが仮想マシンに対して実行できるアクションを変更する

PS C:\> $UserRole = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCUserRole -UserRole $UserRole -Permission "Create,PauseAndResume,Stop,AllowLocalAdmin,Store"

最初のコマンドは、ContosoSelfServiceUsers という名前の VMMServer01 のユーザーロールオブジェクトを取得し、そのオブジェクトを $UserRole 変数に格納します。

2 番目のコマンドは、作成、PauseAndResume、Stop、AllowLocalAdmin、およびストアのアクセス許可を許可するように、$UserRoleに格納されているユーザーロールのメンバーのアクセス許可を変更します。

パラメーター

-AddMember

このコマンドレットがグループなどのメンバーの概念を持つオブジェクトに追加するメンバーの配列を指定します。たとえば、このコマンドレットでは、1 つ以上の Active Directory® Domain Services ドメインユーザーまたはグループをユーザーロールに追加できます。次の形式でメンバーを指定します。

Domain\User
利用者
User@Domain
Domain\LabGroupAlias
LabGroupAlias

ラボグループのエイリアスは、電子メールエイリアスではなく、Active Directory Domain Services セキュリティグループです。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddScope

このコマンドレットが、このユーザーロールのメンバーが管理できるオブジェクトのスコープに追加するスコープの配列を指定します。

型:	ClientObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-JobGroup

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

型:	Guid
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-JobVariable

ジョブの進行状況を追跡して格納する変数を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NATConnectionMaximum

型:	UInt16
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NATConnectionMaximumPerUser

型:	UInt16
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OnBehalfOfUser

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OnBehalfOfUserRole

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

型:	UserRole
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Permission

Self-Service ユーザーロールのメンバーが仮想マシンまたはサービスで実行できるアクションの配列を指定します。有効な値は次のとおりです。

AllowLocalAdmin
著者
CanShare
CanReceive
チェックポイント
CheckpointRestoreOnly
創造する
CreateFromVHDOrTemplate
PauseAndResume
RemoteConnect
取り去る
セーブ
シャットダウン
始める
止める
店

CreateFromVHDOrTemplate アクセス許可を付与する場合は、Create アクセス許可も付与します。 Checkpoint アクセス許可を付与する場合は、CheckpointRestoreOnly アクセス許可も付与します。

型:	SelfServicePermission[]
Aliases:	VMPermission
指定可能な値:	Create, PauseAndResume, Start, Stop, AllowLocalAdmin, RemoteConnect, Remove, Shutdown, Checkpoint, Store, Save, Author, CanShare, CanReceive, CreateFromVHDOrTemplate, CheckpointRestoreOnly, AuthorVMNetwork, CreateShielded
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PROTipID

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

型:	Guid
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveLibraryStoreSharePath

このコマンドレットが、セルフサービスユーザーのユーザーロールデータパスをクリアすることを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveMember

グループなどのメンバーシップの概念を持つ VMM オブジェクトからこのコマンドレットが削除するメンバーの配列を指定します。たとえば、このコマンドレットは、1 つまたは複数の Active Directory Domain Services ドメインユーザーまたはグループをユーザーロールから削除できます。次の形式でメンバーを指定します。

Domain\User
利用者
User@Domain
Domain\LabGroupAlias
LabGroupAlias

ラボグループのエイリアスは、電子メールエイリアスではなく、Active Directory Domain Services セキュリティグループです。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveNATConnectionMaximum

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveNATConnectionMaximumPerUser

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveScope

このユーザーロールのメンバーが管理できるオブジェクトのスコープから削除する VMM オブジェクトの配列を指定します。

型:	ClientObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveVMNetworkMaximum

このコマンドレットが仮想マシンネットワークの最大設定を削除することを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveVMNetworkMaximumPerUser

このコマンドレットは、ユーザー設定ごとの仮想マシンネットワークの最大値を削除することを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveVMNetworkVPNMaximumBandwidthIn

このコマンドレットは、受信接続の仮想プライベートネットワーク (VPN) の最大帯域幅設定を削除することを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveVMNetworkVPNMaximumBandwidthOut

このコマンドレットは、送信接続の VPN の最大帯域幅設定を削除することを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveVPNConnectionMaximum

このコマンドレットが VPN 接続の最大設定を削除することを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveVPNConnectionMaximumPerUser

このコマンドレットは、ユーザー設定ごとの VPN 接続の最大値を削除することを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RunAsynchronously

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ShowPROTips

PRO ヒントを表示するかどうかを示します。このパラメーターは、Self-Service ユーザーロールにのみ適用されます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserRole

このコマンドレットが変更するユーザーロールオブジェクトを指定します。ユーザーロールを取得するには、Get-SCUserRole コマンドレットを使用します。

型:	UserRole
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UserRoleDataPath

Self-Service ユーザーロールのメンバーがデータのアップロードに使用できるライブラリ共有のパスを指定します。次の形式でパスを指定します: \LibraryServerName\LibraryShareName。

型:	String
Aliases:	LibraryStoreSharePath
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMMServer

このコマンドレットがユーザーロールを変更する VMM サーバーを指定します。

型:	ServerConnection
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMNetworkMaximum

ユーザーロールの仮想マシンネットワークの最大数を指定します。

型:	UInt16
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMNetworkMaximumPerUser

ユーザーの仮想マシンネットワークの最大数を指定します。

型:	UInt16
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMNetworkVPNMaximumBandwidthInKbps

VPN の着信トラフィックの最大帯域幅 (キロビット/秒) を指定します。

型:	UInt64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMNetworkVPNMaximumBandwidthOutKbps

VPN の送信トラフィックの最大帯域幅 (キロビット/秒) を指定します。

型:	UInt64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VPNConnectionMaximum

VPN の接続の最大数を指定します。

型:	UInt16
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VPNConnectionMaximumPerUser

VPN のユーザーあたりの接続の最大数を指定します。

型:	UInt16
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

UserRole

メモ

セルフサービスユーザーに対して指定できる使用可能なすべてのアクセス許可を一覧表示するには、次のコマンドを入力します。

PS C:\> [enum]::GetValues([Microsoft.VirtualManager.Remoting.SelfServicePermission])

次の方法で共有