New-SCService
VMM で新しいサービス インスタンスをデプロイします。
構文
New-SCService
[-PersistServiceConfiguration]
[-Owner <String>]
[-VMMServer <ServerConnection>]
-ServiceConfiguration <ServiceConfiguration>
[-UserRole <UserRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
New-SCService コマンドレットは、仮想マシン マネージャー (VMM) 環境に新しいサービス インスタンスをデプロイします。 サービス インスタンス構成が必要ない場合は、サービス テンプレートから直接、またはサービス構成からサービスを作成できます。
例
例 1: ライブラリに格納されているサービス構成を使用してサービス テンプレートをデプロイする
PS C:\> $SvcConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> Update-SCServiceConfiguration -ServiceConfiguration $SvcConfig
PS C:\> $NewService = New-SCService -ServiceConfiguration $SvcConfig
PS C:\> $NewService
最初のコマンドは、Contoso Service Configuration 01 という名前のサービス構成オブジェクトを取得し、そのオブジェクトを $SvcConfig 変数に格納します。
2 番目のコマンドは、配置を実行して、$SvcConfigに格納されているサービス構成を更新します。
3 番目のコマンドは、$SvcConfigに格納されているサービス構成を使用して新しいサービスをデプロイします。
最後のコマンドは、新しくデプロイされたサービスのプロパティをユーザーに表示します。
パラメーター
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-Owner
有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。
- 形式の例:
-Owner "Contoso\PattiFuller"
- 形式の例:
-Owner "PattiFuller@Contoso"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistServiceConfiguration
サービスの展開の構成が、サービスの展開後に VMM ライブラリに格納されることを示します。
Type: | SwitchParameter |
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 |
-ServiceConfiguration
サービス構成オブジェクトを指定します。
Type: | ServiceConfiguration |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserRole
ユーザー ロール オブジェクトを指定します。
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
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 |
出力
Service
このコマンドレットは 、Service オブジェクトを返します。