New-ServiceFabricNodeConfiguration

Service Fabric クラスターに参加するようにノードを構成します。 開発クラスターと Azure クラスターに対して機能します。

構文

New-ServiceFabricNodeConfiguration
   [-ClusterManifestPath] <String>
   [-InfrastructureManifestPath <String>]
   [-FabricDataRoot <String>]
   [-FabricLogRoot <String>]
   [-FabricHostCredential <PSCredential>]
   [-RunFabricHostServiceAsManual]
   [-RemoveExistingConfiguration]
   [-BootstrapMSIPath <String>]
   [-UsingFabricPackage]
   [-FabricPackageRoot <String>]
   [-MachineName <String>]
   [<CommonParameters>]

説明

New-ServiceFabricNodeConfiguration コマンドレットは、Service Fabric クラスターに追加できるようにノードを構成します。 これには、必要に応じて Service Fabric をインストールし、クラスター マニフェストから取得した構成情報を使用して、ノードがクラスターに参加するために必要な設定が作成されます。

ノードは、ホスト コンピューターで Service Fabric ホスト サービスが開始されるとすぐにクラスターに参加します。

Service Fabric クラスターを管理するには、[管理者として実行] オプションを使用して、Windows PowerShell セッションを開始してください。

このコマンドでは、この操作が適用されるクラスターの種類に応じて、パラメーターの使用法が異なります。 いずれの場合も、このコマンドを使用してクラスターにノードを追加します。 スタンドアロン クラスターを使用している場合は、 AddNode コマンドを参照してください。

例 1: 5 ノードの開発クラスターを構成する

PS C:\> New-ServiceFabricNodeConfiguration -ClusterManifestPath "<samples>\\ConfigStore\Management\Deployment\ClusterManifest\Server\DevEnv-FiveNodes.xml"

このコマンドは、Service Fabric サンプルのDevEnv-FiveNodes.xml マニフェストを使用して開発クラスターを構成します。 このマニフェストでは、開発用コンピューター上の 5 つのノードで構成された Service Fabric クラスターが構成されます。

パラメーター

-BootstrapMSIPath

ブートストラップ .msi ファイルのパスを指定します。 これは、Service Fabric Web サイトからダウンロードした Service Fabric SDK です。 このパラメーターを使用すると、アップグレードが構成されているか、ファブリックがアップグレードされたときに、自己ベースライン アップグレードが自動的に行われます。 UsingFabricPackage が設定されている場合は、.msi ファイルではなく Service Fabric CAB ファイルを指す必要があります。 Service Fabric CAB ファイルは 、ここからダウンロードできます。

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

-ClusterManifestPath

Service Fabric クラスター マニフェストのパス (XML ファイル) を指定します。 このファイルのサンプルは、 Service Fabric のサンプル の 「PublishProfiles」にあります。 コマンドレットは、指定したマニフェストに基づいてクラスター構成を作成します。

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

-FabricDataRoot

Service Fabric ランタイムがクラスターの操作に必要な内部データを格納するパスを指定します。

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

-FabricHostCredential

Service Fabric ホスト サービスの PSCredential オブジェクトを指定します。 PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細を表示するには「Get-Help Get-Credential」を入力します。

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

-FabricLogRoot

Service Fabric トレース ログのパスを指定します。

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

-FabricPackageRoot

このパラメーターは将来使用するために予約されています。

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

-InfrastructureManifestPath

インフラストラクチャ マニフェストのパスを指定します。 このマニフェストは、各ノードにクラスターの概要を示すために使用されます。 たとえば、クラスター上のノードの合計量です。 Azure では、これは .csdef ファイルと .cscfg ファイルへのパスです。

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

-MachineName

構成をホストするコンピューターを指定します。 コンピューター名またはコンピューターの IP アドレスを使用できます。 次に例を示します。

-MachineName "192.168.1.1"

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

-RemoveExistingConfiguration

このコマンドレットによって既存の構成が削除されることを示します。 これらの構成は、FabricDataRoot と FabricLogRoot によって指定されたフォルダーにあるデータで構成されます。

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

-RunFabricHostServiceAsManual

ファブリック ホスト サービスを手動で開始する必要があることを示します。

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

-UsingFabricPackage

ノード構成で xcopy/CAB ランタイム パッケージを使用する必要があることを示します。 これは、Service Fabric Web サイトからダウンロードできます。 これは、MSI がインストールされておらず、クライアント パッケージを使用してコマンドレットを実行している場合に使用されます。 xcopy/CAB パッケージへのパスは、パラメーター -BootstrapMSIPath に設定する必要があります。

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

入力

None

出力

System.Object