Freigeben über


New-ServiceFabricNodeConfiguration

Konfiguriert einen Knoten, um einem Service Fabric-Cluster beizutreten. Arbeitet für Entwicklungscluster und Azure-Cluster.

Syntax

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

Beschreibung

Das New-ServiceFabricNodeConfiguration Cmdlet konfiguriert einen Knoten, der einem Service Fabric-Cluster hinzugefügt werden kann. Dies umfasst die Installation von Service Fabric bei Bedarf und anschließend die Verwendung von Konfigurationsinformationen aus dem Clustermanifest und erstellt dann die für den Knoten erforderlichen Einstellungen, um dem Cluster beizutreten.

Der Knoten wird dem Cluster beitreten, sobald der Service Fabric-Hostdienst auf dem Hostcomputer gestartet wird.

Um Service Fabric-Cluster zu verwalten, stellen Sie sicher, dass Sie Ihre Windows PowerShell-Sitzung mithilfe der Option "Als Administrator ausführen" starten.

Dieser Befehl hat unterschiedliche Verwendungen von Parametern, je nachdem, auf welche Art von Cluster dieser Vorgang angewendet wird. In allen Fällen wird dieser Befehl verwendet, um einem Cluster einen Knoten hinzuzufügen. Wenn Sie einen eigenständigen Cluster verwenden, lesen Sie bitte den Befehl AddNode.

Beispiele

Beispiel 1: Konfigurieren eines Fünf-Knoten-Entwicklungsclusters

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

Mit diesem Befehl wird ein Entwicklungscluster mithilfe des DevEnv-FiveNodes.xml Manifests aus den Service Fabric-Beispielen konfiguriert. Dieses Manifest konfiguriert einen Service Fabric-Cluster mit fünf Knoten auf Ihrem Entwicklungscomputer.

Parameter

-BootstrapMSIPath

Gibt den Pfad der Bootstrap-.msi Datei an. Dies ist das Service Fabric SDK, das von der Service Fabric-Website heruntergeladen wurde. Wenn Sie diesen Parameter verwenden, tritt automatisch ein Self-Baseline-Upgrade auf, wenn entweder ein Upgrade konfiguriert oder fabric aktualisiert wird. Wenn -UsingFabricPackage festgelegt ist, sollte dies auf die Service Fabric CAB-Datei und nicht auf die .msi-Datei verweisen. Die Service Fabric CAB-Datei ist zum Download hierverfügbar.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClusterManifestPath

Gibt den Pfad eines Service Fabric-Clustermanifests an, bei dem es sich um eine XML-Datei handelt. Beispiele dieser Datei finden Sie in Service Fabric-Beispielen unter "PublishProfiles". Das Cmdlet erstellt eine Clusterkonfiguration basierend auf dem angegebenen Manifest.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FabricDataRoot

Gibt den Pfad an, in dem die Service Fabric-Laufzeit die internen Daten speichert, die zum Ausführen eines Clusters erforderlich sind.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FabricHostCredential

Gibt ein PSCredential- -Objekt für den Service Fabric-Hostdienst an. Um ein PSCredential-Objekt abzurufen, verwenden Sie das Cmdlet Get-Credential. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FabricLogRoot

Gibt den Pfad für die Service Fabric-Ablaufverfolgungsprotokolle an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FabricPackageRoot

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InfrastructureManifestPath

Gibt den Pfad des Infrastrukturmanifests an. Dieses Manifest wird verwendet, um jedem Knoten einen Überblick über den Cluster zu geben. Beispielsweise die Gesamtmenge der Knoten im Cluster. In Azure ist dies der Pfad zu den CSDEF- und CSCFG-Dateien.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MachineName

Gibt den Computer an, auf dem die Konfiguration gehostet wird. Sie können entweder den Computernamen oder die IP-Adresse des Computers verwenden. Zum Beispiel:

-MachineName "192.168.1.1"

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveExistingConfiguration

Gibt an, dass dieses Cmdlet vorhandene Konfigurationen entfernt. Diese Konfigurationen bestehen aus Daten, die in den Ordnern mit FabricDataRoot und FabricLogRoot gefunden wurden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunFabricHostServiceAsManual

Gibt an, dass der Fabric-Hostdienst manuell gestartet werden muss.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UsingFabricPackage

Gibt an, dass Knotenkonfigurationen das Xcopy/CAB-Laufzeitpaket verwenden sollen. Dies kann von der Service Fabric-Website heruntergeladen werden. Dies wird verwendet, wenn MSI nicht installiert ist und wir ein Clientpaket verwenden, um das Cmdlet auszuführen. Der Pfad zum xcopy/CAB-Paket sollte im Parameter "-BootstrapMSIPath" festgelegt werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object