New-SCServiceConfiguration
サービス テンプレートからサービス構成を作成します。
構文
New-SCServiceConfiguration
[-Name] <String>
[-Description <String>]
[-VMMServer <ServerConnection>]
-ServiceTemplate <ServiceTemplate>
[-ServicePriority <String>]
-VMHostGroup <HostGroup>
[-Tag <String>]
[-CostCenter <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] New-SCServiceConfiguration
[-Name] <String>
[-Description <String>]
[-VMMServer <ServerConnection>]
-ServiceTemplate <ServiceTemplate>
[-ServicePriority <String>]
-Cloud <Cloud>
[-Tag <String>]
[-CostCenter <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] 説明
New-SCServiceConfiguration コマンドレットは、サービス テンプレートからサービス構成を作成します。 サービス構成には、サービスのデプロイ時に使用されるインスタンス固有の値が含まれています。
例
例 1: ホスト グループのサービス構成を作成する
PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $ServiceConfig = New-SCServiceConfiguration -ServiceTemplate $ServiceTemplate -Name "Service01" -VMHostGroup $HostGroup -Description "Contoso Service 01" -ServicePriority High -CostCenter 1033
PS C:\> $ServiceConfig最初のコマンドは、すべての Hosts\HostGroup02\Production というパスを持つホスト グループ オブジェクトを取得し、$HostGroup変数にオブジェクトを格納します。
2 番目のコマンドは、ServiceTemplate01 という名前のサービス テンプレート オブジェクトを取得し、$ServiceTemplate変数に格納します。
3 番目のコマンドは、$ServiceTemplateに格納されているサービス テンプレート オブジェクトを使用して、$HostGroupに格納されているホスト グループのサービス構成オブジェクトをライブラリに作成します。 その後、コマンドは新しいサービス構成オブジェクトを $ServiceConfig 変数に格納します。
最後のコマンドは、新しいサービス構成オブジェクトのプロパティをユーザーに表示します。
例 2: プライベート クラウドのサービス構成を作成する
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $ServiceConfig = New-SCServiceConfiguration -ServiceTemplate $ServiceTemplate -Name "Service02" -Cloud $Cloud -Description "Contoso Cloud Service" -ServicePriority High -CostCenter 1033
PS C:\> $ServiceConfig最初のコマンドは、Production という名前のプライベート クラウド オブジェクトを取得し、$Cloud変数にオブジェクトを格納します。
2 番目のコマンドは、ServiceTemplate01 という名前のサービス テンプレート オブジェクトを取得し、$ServiceTemplate変数に格納します。
3 番目のコマンドは、$ServiceTemplateに格納されているサービス テンプレート オブジェクトを使用して、$Cloudに格納されているプライベート クラウドのライブラリにサービス構成オブジェクトを作成します。 その後、コマンドは新しいサービス構成オブジェクトを $ServiceConfig 変数に格納します。
最後のコマンドは、新しいサービス構成オブジェクトのプロパティをユーザーに表示します。
パラメーター
-Cloud
プライベート クラウド オブジェクトを指定します。
| 型: | Cloud |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CostCenter
仮想マシン (または仮想マシンに割り当てられたリソース) の割り当てに関するデータを収集して課金システムで使用できるように、仮想マシンのコスト センターを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
サービス構成の説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
仮想マシン マネージャー (VMM) オブジェクトの名前を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ServicePriority
サービスの優先順位を指定します。 有効な値は、Normal、Low、High です。 既定値: 標準。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ServiceTemplate
サービス テンプレート オブジェクトを指定します。
| 型: | ServiceTemplate |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Tag
指定したタグのセットを持つすべてのオブジェクトを検索できるように、オブジェクトに関連付ける単語または語句を指定します。 タグのサブセットを検索することも、タグの完全なセットを検索することもできます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMHostGroup
仮想マシンのホスト グループ オブジェクトまたはホスト グループ オブジェクトの配列を指定します。
| 型: | HostGroup |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
ServiceConfiguration
このコマンドレットは、ServiceConfiguration オブジェクトを返します。