New-ServiceFabricNodeConfiguration

  • リファレンス
モジュール:
ServiceFabric

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 Host Service がホスト マシンで開始されるとすぐにクラスターに参加します。

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 ファイルは、ダウンロードできます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClusterManifestPath

Service Fabric クラスター マニフェストのパス (XML ファイル) を指定します。 このファイルのサンプルは、"PublishProfiles" の下 Service Fabric のサンプル で確認できます。 このコマンドレットは、指定されたマニフェストに基づいてクラスター構成を作成します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FabricDataRoot

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FabricHostCredential

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

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FabricLogRoot

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FabricPackageRoot

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InfrastructureManifestPath

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MachineName

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

-MachineName "192.168.1.1"

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveExistingConfiguration

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunFabricHostServiceAsManual

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UsingFabricPackage

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

System.Object