New-ServiceFabricServiceGroup

Service Fabric サービス グループを作成します。

構文

New-ServiceFabricServiceGroup
   [-Stateless]
   [-PartitionSchemeSingleton]
   [-ApplicationName] <Uri>
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -InstanceCount <Int32>
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateful]
   [-PartitionSchemeSingleton]
   [-ApplicationName] <Uri>
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   [-HasPersistedState]
   -TargetReplicaSetSize <Int32>
   -MinReplicaSetSize <Int32>
   [-ReplicaRestartWaitDuration <TimeSpan>]
   [-QuorumLossWaitDuration <TimeSpan>]
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateful]
   [-PartitionSchemeUniformInt64]
   [-ApplicationName] <Uri>
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -PartitionCount <Int32>
   -LowKey <Int64>
   -HighKey <Int64>
   [-HasPersistedState]
   -TargetReplicaSetSize <Int32>
   -MinReplicaSetSize <Int32>
   [-ReplicaRestartWaitDuration <TimeSpan>]
   [-QuorumLossWaitDuration <TimeSpan>]
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateful]
   [-PartitionSchemeNamed]
   [-ApplicationName] <Uri>
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -PartitionNames <String[]>
   [-HasPersistedState]
   -TargetReplicaSetSize <Int32>
   -MinReplicaSetSize <Int32>
   [-ReplicaRestartWaitDuration <TimeSpan>]
   [-QuorumLossWaitDuration <TimeSpan>]
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateful]
   [-PartitionSchemeSingleton]
   [-Adhoc]
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   [-HasPersistedState]
   -TargetReplicaSetSize <Int32>
   -MinReplicaSetSize <Int32>
   [-ReplicaRestartWaitDuration <TimeSpan>]
   [-QuorumLossWaitDuration <TimeSpan>]
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateful]
   [-PartitionSchemeUniformInt64]
   [-Adhoc]
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -PartitionCount <Int32>
   -LowKey <Int64>
   -HighKey <Int64>
   [-HasPersistedState]
   -TargetReplicaSetSize <Int32>
   -MinReplicaSetSize <Int32>
   [-ReplicaRestartWaitDuration <TimeSpan>]
   [-QuorumLossWaitDuration <TimeSpan>]
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateful]
   [-PartitionSchemeNamed]
   [-Adhoc]
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -PartitionNames <String[]>
   [-HasPersistedState]
   -TargetReplicaSetSize <Int32>
   -MinReplicaSetSize <Int32>
   [-ReplicaRestartWaitDuration <TimeSpan>]
   [-QuorumLossWaitDuration <TimeSpan>]
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateless]
   [-PartitionSchemeUniformInt64]
   [-ApplicationName] <Uri>
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -PartitionCount <Int32>
   -LowKey <Int64>
   -HighKey <Int64>
   -InstanceCount <Int32>
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateless]
   [-PartitionSchemeNamed]
   [-ApplicationName] <Uri>
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -PartitionNames <String[]>
   -InstanceCount <Int32>
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateless]
   [-PartitionSchemeSingleton]
   [-Adhoc]
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -InstanceCount <Int32>
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateless]
   [-PartitionSchemeUniformInt64]
   [-Adhoc]
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -PartitionCount <Int32>
   -LowKey <Int64>
   -HighKey <Int64>
   -InstanceCount <Int32>
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
New-ServiceFabricServiceGroup
   [-Stateless]
   [-PartitionSchemeNamed]
   [-Adhoc]
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   -PartitionNames <String[]>
   -InstanceCount <Int32>
   [-PlacementConstraint <String>]
   [-Metric <String[]>]
   [-Correlation <String[]>]
   [-PlacementPolicy <String[]>]
   -ServiceGroupMemberDescription <Hashtable[]>
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

説明

New-ServiceFabricServiceGroup コマンドレットは、Service Fabric サービス グループを作成します。 このコマンドレットは、New-ServiceFabricService コマンドレットに似ていますが、このコマンドレットではサービス グループが作成され、 New-ServiceFabricService によってサービスが作成される点が異なります。

Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例 1: ステートフル サービス グループを作成する

PS C:\> New-ServiceFabricServiceGroup -ApplicationName fabric:/myapp/persistenttodolist -ServiceName fabric:/myapp/persistenttodolist/svc1 -ServiceTypeName "PersistentToDoListServiceGroupType" -Stateful -PartitionSchemeSingleton -TargetReplicaSetSize 3 -MinReplicaSetSize 2 -ServiceGroupMemberDescription @(@{"ServiceName"="fabric:/myapp/persistenttodolist/svc1#a";"ServiceTypeName"=" PersistentToDoListServiceGroupTypeA"},@{"ServiceName"="fabric:/myapp/persistenttodolist/svc1#b";"ServiceTypeName"=" PersistentToDoListServiceGroupTypeB"})

このコマンドは、シングルトン パーティション構成を使用して、指定したアプリケーション インスタンスから Service Fabric ステートフル サービス グループを作成します。

パラメーター

-Adhoc

サービスがアドホック モードで実行されることを示します。 アドホック モードでは、サービス ホストを手動でアクティブ化します。

Type:SwitchParameter
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

Service Fabric アプリケーションの Uniform Resource Identifier (URI) を指定します。 コマンドレットは、指定した URI を持つアプリケーションに基づいてサービス グループを作成します。

Type:Uri
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Correlation

このサービスの相関制約の配列を指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HasPersistedState

ステートフル サービスに永続的な状態があることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HighKey

パーティション セットの高キー範囲を指定します。

Type:Int64
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InstanceCount

ステートレス サービスのインスタンスの数を指定します。

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LowKey

パーティション セットのキーの低い範囲を指定します。

Type:Int64
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Metric

サービスが報告するメトリックの配列を指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinReplicaSetSize

Service Fabric ステートフル サービスの最小レプリカ セット サイズを指定します。

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionCount

サービスのパーティション数を指定します。

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionNames

パーティションの名前の配列を指定します。

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionSchemeNamed

サービスが名前付きパーティション構成を使用することを示します。

Type:SwitchParameter
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionSchemeSingleton

サービスがシングルトン パーティション構成を使用することを示します。

Type:SwitchParameter
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionSchemeUniformInt64

サービスが UniformInt64 パーティション構成を使用することを示します。

Type:SwitchParameter
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PlacementConstraint

サービスの配置の制約を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PlacementPolicy

サービスの配置ポリシーの配列を指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-QuorumLossWaitDuration

サービス パーティションのデータ損失を宣言する前に Service Fabric が待機する 期間を TimeSpan オブジェクトとして指定します。 TimeSpan オブジェクトを取得するには、New-TimeSpan コマンドレットを使用します。 詳細を表示するには「Get-Help New-TimeSpan」を入力します。

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaRestartWaitDuration

Service Fabric がレプリカの再起動を待機してからレプリカをフェールオーバーする間隔を TimeSpan オブジェクトとして指定します。 TimeSpan オブジェクトを取得するには、New-TimeSpan コマンドレットを使用します。

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceGroupMemberDescription

サービス グループのメンバー構成を示します。 このパラメーターの値を次の形式で指定します。

@(@{"ServiceName"=<serviceName>;"ServiceTypeName"=<serviceType>;"LoadMetrics"=<metrics>})。

例: @(@{"ServiceName"="fabric:/myapp/calculator/svc1;"ServiceTypeName"="CalculatorServiceType"})

Type:Hashtable[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServiceName

Service Fabric サービス グループの URI を指定します。

Type:Uri
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServicePackageActivationMode

サービスに使用する [ホスティング モデル][1] を制御します。 有効な値は SharedProcessExclusiveProcess です。 既定値は SharedProcess です

SharedProcess アクティブ化モードでは、特定の ServiceType のさまざまなサービスのレプリカ (またはインスタンス) が同じ ServiceHost を共有します。 ExclusiveProcess アクティブ化モードでは、サービスの各レプリカまたはインスタンスに独自の専用 ServiceHost が設定されます。 詳細については、「Service Fabric ホスティング モデル][1」を参照してください。

Type:ServicePackageActivationMode
Accepted values:SharedProcess, ExclusiveProcess
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceTypeName

Service Fabric サービスの種類の名前を指定します。

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Stateful

サービスが Service Fabric ステートフル サービスであることを示します。

Type:SwitchParameter
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Stateless

サービスが Service Fabric ステートレス サービスであることを示します。

Type:SwitchParameter
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetReplicaSetSize

Service Fabric ステートフル サービスのターゲット レプリカ セット サイズを指定します。

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

出力

System.Object