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 コマンドレットは、Virtual Machine Manager (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 オブジェクトを返します。