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
プライベート クラウド オブジェクトを指定します。
| Type: | Cloud |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CostCenter
仮想マシン (または仮想マシンに割り当てられたリソース) の割り当てに関するデータを収集して、課金システムで使用できるように、仮想マシンのコスト センターを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
サービス構成の説明を指定します。
| Type: | String |
| 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
仮想マシン マネージャー (VMM) オブジェクトの名前を指定します。
| 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 |
-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 |
-ServicePriority
サービスの優先度を指定します。 有効な値は、標準、低、高です。 既定値: 標準。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceTemplate
サービス テンプレート オブジェクトを指定します。
| Type: | ServiceTemplate |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
指定したタグのセットを持つすべてのオブジェクトを検索できるように、オブジェクトに関連付ける単語または語句を指定します。 タグのサブセットを検索することも、タグの完全なセットを検索することもできます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
仮想マシン ホスト グループ オブジェクトまたはホスト グループ オブジェクトの配列を指定します。
| Type: | HostGroup |
| 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 |
出力
ServiceConfiguration
このコマンドレットは 、ServiceConfiguration オブジェクトを返します。