Add-SCUserRolePermission

モジュール:

VirtualMachineManager

ユーザー ロールにアクセス許可を追加します。

構文

Add-SCUserRolePermission
   [-VMMServer <ServerConnection>]
   -UserRole <SelfServiceUserRole>
   -Cloud <Cloud>
   [-AllowLocalAdmin]
   [-Checkpoint]
   [-CheckpointRestoreOnly]
   [-DeployFromTemplateOnly]
   [-Deploy]
   [-PauseAndResume]
   [-RemoteConnect]
   [-Remove]
   [-Save]
   [-Shutdown]
   [-Start]
   [-Stop]
   [-Store]
   [-DeployShielded]
   [-MigrateVM]
   [-UpdateVMFunctionalLevel]
   [-ManageAzureProfiles]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCUserRolePermission
   [-VMMServer <ServerConnection>]
   -UserRole <SelfServiceUserRole>
   [-AllowLocalAdmin]
   [-Author]
   [-AuthorVMNetwork]
   [-CanShare]
   [-CanReceive]
   [-Checkpoint]
   [-CheckpointRestoreOnly]
   [-DeployFromTemplateOnly]
   [-Deploy]
   [-PauseAndResume]
   [-RemoteConnect]
   [-Remove]
   [-Save]
   [-Shutdown]
   [-Start]
   [-Stop]
   [-Store]
   [-DeployShielded]
   [-MigrateVM]
   [-UpdateVMFunctionalLevel]
   [-ManageAzureProfiles]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCUserRolePermission
   -UserRole <SelfServiceUserRole>
   -HostGroup <HostGroup>
   [-VMMServer <ServerConnection>]
   [-AllowLocalAdmin]
   [-Checkpoint]
   [-CheckpointRestoreOnly]
   [-DeployFromTemplateOnly]
   [-Deploy]
   [-PauseAndResume]
   [-RemoteConnect]
   [-Remove]
   [-Save]
   [-Shutdown][-Start]
   [-Stop]
   [-Store]
   [-DeployShielded]
   [-MigrateVM]
   [-UpdateVMFunctionalLevel]
   [-ManageAzureProfiles]
   [-RunAsynchronously]
   [-PROTipID <guid>]
   [-JobVariable <string>]
   [-OnBehalfOfUser <string>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCUserRolePermission
   [-VMMServer <ServerConnection>]
   [-Cloud <Cloud>]
   -JobGroup <Guid>
   [-AllowLocalAdmin]
   [-Author]
   [-AuthorVMNetwork]
   [-CanShare]
   [-CanReceive]
   [-Checkpoint]
   [-CheckpointRestoreOnly]
   [-DeployFromTemplateOnly]
   [-Deploy]
   [-PauseAndResume]
   [-RemoteConnect]
   [-Remove]
   [-Save]
   [-Shutdown]
   [-Start]
   [-Stop]
   [-Store]
   [-DeployShielded]
   [-MigrateVM]
   [-UpdateVMFunctionalLevel]
   [-ManageAzureProfiles]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCUserRolePermission
   [-VMMServer <ServerConnection>]
   [-HostGroup <HostGroup>]
   -JobGroup <Guid>
   [-AllowLocalAdmin]
   [-Author]
   [-AuthorVMNetwork]
   [-CanShare]
   [-CanReceive]
   [-Checkpoint]
   [-CheckpointRestoreOnly]
   [-DeployFromTemplateOnly]
   [-Deploy]
   [-PauseAndResume]
   [-RemoteConnect]
   [-Remove]
   [-Save]
   [-Shutdown]
   [-Start]
   [-Stop]
   [-Store]
   [-DeployShielded]
   [-MigrateVM]
   [-UpdateVMFunctionalLevel]
   [-ManageAzureProfiles]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCUserRolePermission
   [-VMMServer <ServerConnection>]
   -UserRolePermission <UserRolePermission>
   [-AllowLocalAdmin]
   [-Checkpoint]
   [-CheckpointRestoreOnly]
   [-DeployFromTemplateOnly]
   [-Deploy]
   [-PauseAndResume]
   [-RemoteConnect]
   [-Remove]
   [-Save]
   [-Shutdown]
   [-Start]
   [-Stop]
   [-Store]
   [-DeployShielded]
   [-MigrateVM]
   [-UpdateVMFunctionalLevel]
   [-ManageAzureProfiles]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Add-SCUserRolePermission コマンドレットは、ユーザー ロールにアクセス許可を付与します。

手記

• HostGroup パラメーターは、UserRole パラメーターが VMAdmin場合にのみ使用できます。
• MigrateVM と UpdateVMFunctionalLevel のアクセス許可は、VMAdmin ユーザー ロールでのみ使用できます。
• ManageAzureProfiles アクセス許可は、すべてのユーザー ロールで使用できます。

パラメーター

-AllowLocalAdmin

このコマンドレットがローカル管理者の許可アクセス許可を付与することを示します。

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

-Author

このコマンドレットが Author アクセス許可を付与することを示します。

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

-AuthorVMNetwork

このコマンドレットが AUTHOR VMNetwork アクセス許可を付与することを示します。

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

-CanReceive

このコマンドレットが受信可能アクセス許可を付与することを示します。

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

-CanShare

このコマンドレットが Can Share アクセス許可を付与することを示します。

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

-Checkpoint

このコマンドレットが Can Checkpoint アクセス許可を付与することを示します。

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

-CheckpointRestoreOnly

このコマンドレットがチェックポイント復元のみ可能アクセス許可を付与することを示します。

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

-Cloud

このコマンドレットがユーザー ロールを変更するプライベート クラウド オブジェクトを指定します。

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

-Deploy

このコマンドレットが仮想マシンのデプロイアクセス許可を付与することを示します。

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

-DeployFromTemplateOnly

このコマンドレットによって、テンプレートからのデプロイのみ仮想マシンのアクセス許可が付与されることを示します。

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

-DeployShielded

このコマンドレットがシールドされた展開アクセス許可を付与することを示します。

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

-HostGroup

このコマンドレットがユーザー ロールを変更するホスト グループ オブジェクトを指定します。

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

-JobGroup

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

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

-JobVariable

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

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

-ManageAzureProfiles

このコマンドレットが、Azure プロファイルの管理 アクセス許可を付与することを示します。

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

-MigrateVM

このコマンドレットが、仮想マシンの移行 アクセス許可を付与することを示します。

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

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

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

-PauseAndResume

このコマンドレットが [一時停止および再開可能] アクセス許可を付与することを示します。

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

-PROTipID

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

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

-RemoteConnect

このコマンドレットがリモート接続アクセス許可を付与することを示します。

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

-Remove

このコマンドレットが "削除可能" アクセス許可を付与することを示します。

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

-RunAsynchronously

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

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

-Save

このコマンドレットが VM の保存可能アクセス許可を付与することを示します。

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

-Shutdown

このコマンドレットが、仮想マシンのシャットダウン可能アクセス許可を付与することを示します。

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

-Start

このコマンドレットが Can Start 仮想マシンのアクセス許可を付与することを示します。

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

-Stop

このコマンドレットが Can Stop 仮想マシンのアクセス許可を付与することを示します。

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

-Store

このコマンドレットが Can Store 仮想マシンのアクセス許可を付与することを示します。

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

-UpdateVMFunctionalLevel

このコマンドレットが仮想マシンの機能レベルを更新するアクセス許可を付与することを示します。

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

-UserRole

このコマンドレットがアクセス許可を追加するユーザー ロールを指定します。

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

-UserRolePermission

このコマンドレットがアクセス許可を追加 UserRolePermission を指定します。 ユーザー ロールのアクセス許可を取得するには、Get-SCUserRolePermission コマンドレットを使用します。

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

-VMMServer

このコマンドレットがユーザー ロールを変更する仮想マシン マネージャー (VMM) サーバーを指定します。

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

出力

UserRole

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

関連リンク

• Get-SCUserRolePermission
• Remove-SCUserRolePermission