Verwalten von Farmen und Knoten
Die in diesem Abschnitt beschriebenen Cmdlets erstellen oder löschen Farmen und die darin enthaltenen Knoten.
Erstellen einer neuen Service Bus for Windows Server-Farm
Das Cmdlet New-SBFarm erstellt eine neue Farm von Service Bus for Windows Server-Knoten. Verwenden Sie das folgende Format, um eine Farm mit automatisch generierten Zertifikaten zu erstellen:
New-SBFarm [-AdminGroup <String>] [-GatewayDBConnectionString <String>] [-HttpsPort <Int32>]
[-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>] [-MessageContainerDBConnectionString <String>]
[-RunAsAccount <String>] [-TcpPort <Int32>] -CertificateAutoGenerationKey <SecureString> -SBFarmDBConnectionString <String>
Verwenden Sie das folgende Format, um eine Farm mit benutzerdefinierten Zertifikaten zu erstellen:
New-SBFarm [-AdminGroup <String>] [-EncryptionCertificateThumbprint <String>] [-GatewayDBConnectionString
<String>] [-HttpsPort <Int32>] [-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>]
[-MessageContainerDBConnectionString <String>] [-RunAsAccount <String>] [-TcpPort <Int32>]
-FarmCertificateThumbprint <String> -SBFarmDBConnectionString <String>
Wenn während der Farmerstellung ein Fehler auftritt oder Sie zu einem Neustart gezwungen sind, weist die erstellte Farmverwaltungsdatenbank möglicherweise einen fehlerhaften Status auf. Unter diesen Umständen wird bei einem Versuch, einer Farm beizutreten, ggf. ein Fehler angezeigt, der besagt, dass der Computer, den Sie der Farm hinzufügen möchten, kein Bestandteil einer Farm ist. Wenn ein solcher Fehler auftritt, müssen Sie die Farmverwaltungsdatenbank löschen und dann erneut erstellen, bevor Sie der Farm neue Knoten hinzufügen können.
In der folgenden Tabelle werden die Optionen für dieses Cmdlet beschrieben.
| Option | Auswirkung |
|---|---|
-SBFarmDBConnectionString <Verbindungszeichenfolge> |
Stellt eine Verbindungszeichenfolge der Konfigurationsdatenbank dar. |
-Admingroup <Administratorgruppe> |
Gibt die Benutzergruppe an, deren Mitglieder Administratorzugriff auf die Datenbanken in der Farm erhalten. Der Standardwert ist die Gruppe BuiltIn\Administrators auf dem Computer. |
-CertificateAutoGenerationKey <SichereZeichenfolge>] |
Gibt den Schlüssel an, den der Installer zum Generieren des neuen SSL-Dienstzertifikats zum Sichern der Kommunikation zwischen den Diensten und ihren Clients verwendet. |
-MessageContainerDBConnectionString <Verbindungszeichenfolge> |
Gibt die Verbindungszeichenfolge für die Datenbankinstanz an, die als Containerdatenbank verwendet wird. |
-MessageBrokerPort <PortNr> |
Gibt den Port an, der für die Nachrichtenbrokerkommunikation verwendet wird. Der Standardwert beträgt 9356. |
-HttpsPort <PortNr> |
Gibt den Port an, der für die HTTPS-Kommunikation verwendet wird. Der Standardwert beträgt 9355. |
-InternalPortRangeStart <Portbereich> |
Gibt den Bereich der Ports an, den die Service Bus for Windows Server-Knoten in Windows Fabric für die Kommunikation untereinander verwenden. Der Parameter Portbereich ist eine einzelne Portnummer, die die erste Portnummer aus einem Bereich von sechs aufeinanderfolgenden Ports darstellt. |
-GatewayDBConnectionString <Verbindungszeichenfolge> |
Gibt die Verbindungszeichenfolge für die Datenbankinstanz an, die als Gatewaydatenbank verwendet wird. Der Gatewaydatenbank verwaltet eingehende Anforderungen und führt den Lastenausgleich aus. |
-TCPPort <PortNr> |
Gibt den Port an, den die Service Bus for Windows Server-Knoten für die Kommunikation untereinander verwenden. Der Standardwert beträgt 9354. |
-EncryptionCertificateThumbprint <Zeichenfolge> |
Das Zertifikat, das zum Sichern der SQL-Verbindungszeichenfolgen verwendet wird. Wenn kein Zertifikat verfügbar ist, wird der Wert von SslCertificate verwendet. Stellt das Verschlüsselungszertifikat dar. |
-FarmCertificateThumbprint <Zeichenfolge> |
Das Zertifikat, das zum Sichern des Zertifikats verwendet wird. Stellen Sie dieses Zertifikat nicht zur Verfügung, wenn Sie CertificateAutoGenerationKey für die automatische Generierung von Zertifikaten angeben. |
Hinzufügen eines neuen Knotens zu einer Farm
Das Cmdlet Add-SBHost fügt einer vorhandenen Farm einen Knoten hinzu. Das Cmdlet Add-SBHost weist das folgende Format auf:
Add-SBHost [-CertificateAutogenerationKey <SecureString>] [-ExternalBrokerPort <Int32>] [-ExternalBrokerUrl <Uri>] -EnableFirewallRules <Boolean> -RunAsPassword <SecureString> -SBFarmDBConnectionString <String>
In der folgenden Tabelle werden die Optionen für dieses Cmdlet beschrieben.
| Option | Auswirkung |
|---|---|
-SBFarmDBConnectionString <Verbindungszeichenfolge> |
Gibt die Verbindungszeichenfolge für die SQL Server-Instanz an, die als Farmverwaltungsdatenbank hinzugefügt wird. |
-RunAsPassword <SichereZeichenfolge> |
Gibt das Kennwort für das Benutzerkonto an, unter dem Dienste für die Farm ausgeführt werden. Wenn alle Computer in einer Farm das gleiche Dienstkonto gemeinsam verwenden, und die Sicherheitsrichtlinie erfordert, dass das Kennwort für das Dienstkonto in regelmäßigen Intervallen geändert wird, müssen Sie auf jedem Computer in der Farm bestimmte Aktionen ausführen, damit Sie in der Lage sind, der Farm weiterhin Knoten hinzuzufügen oder Knoten aus ihr zu entfernen. Weitere Informationen zu diesem Verfahren finden Sie im Abschnitt Behandeln von Kennwortänderungen der Farm. |
-CertificateAutoGenerationKey <SichereZeichenfolge>] |
Gibt den Schlüssel an, den die Farm zum Sichern der automatisch generierten Zertifikate verwendet. |
-EnableFirewallRules <Boolescher Wert> |
Wenn der Wert true ist, werden Firewallregeln auf dem Host aktiviert. |
-ExternalBrokerPort <Int32> |
Stellt den Port dar, den Service Bus for Windows Server für ExternalBroker-Kommunikation verwendet. |
-ExternalBrokerUrl <URI> |
Gibt einen ExternalBroker-URI an, für den zwischen Groß- und Kleinschreibung unterschieden wird. |
Das Installationsprogramm generiert automatisch die folgenden Zertifikate basierend auf Ihrer Auswahl, wenn es der Farm den Knoten hinzufügt:
| Zertifikattyp | Name | Aussteller |
|---|---|---|
Zertifizierungsstelle |
AppServerGeneratedSBCA |
|
FarmCertificate |
AppServerGeneratedSBCA |
AppServerGeneratedSBCA |
Entfernen eines Knotens aus einer Farm
Das Cmdlet Remove-SBHost entfernt einen Knoten aus einer vorhandenen Farm. Wenn die Farm beim Ausführen dieses Cmdlets aktuell angehalten ist, werden ggf. Fehler oder Warnungen ausgegeben. Sie können die Fehler und Warnungen ignorieren und Start-SBFarm nach Remove-SBHost ausführen, damit die Änderungen wirksam werden. Wenn die Farm ausgeführt wird, ist die Ausführung von Start-SBFarm nicht erforderlich.
Dieses Cmdlet weist das folgende Format auf:
Remove-SBHost [-SBFarmDBConnectionString <string>] [-HostName <string>] [<CommonParameters>]
In der folgenden Tabelle werden die Optionen für dieses Cmdlet beschrieben.
| Option | Auswirkung |
|---|---|
-SBFarmDBConnectionString <Verbindungszeichenfolge> |
Gibt die Verbindungszeichenfolge für die SQL Server-Instanz an, die aus der Farm entfernt wird. Wenn Sie diesen Parameter nicht angeben, sucht das Cmdlet die Verbindungszeichenfolge in der Registrierung. |
-HostName<Zeichenfolge> |
Der Name des Hosts, der entfernt werden soll. Wenn Sie diesen Parameter nicht angeben, wird der Host entfernt, auf dem das Cmdlet ausgeführt wird. Hinweis Sie müssen einen HostName angeben, wenn der Host nicht mehr verfügbar ist und die Farmkonfiguration bereinigt werden soll. |
Wenn Sie einen Computer umbenennen möchten, der zu einer Farm gehört, müssen Sie dieses Cmdlet zum Entfernen des Computers aus der Farm verwenden, bevor Sie ihn umbenennen, und ihn anschließend der Farm mithilfe des Cmdlets Add-SBHost erneut hinzufügen. Wenn für dieses Cmdlet ein Timeoutfehler auftritt, können Sie trotzdem versuchen, das Cmdlet Add-SBHost auszuführen, um ihn erneut der Farm hinzuzufügen. Wenn Add-SBHost erfolgreich ist, können Sie den vorherigen Timeoutfehler ignorieren.
Wenn Sie eine Farm verlassen, belässt das Deinstallationsprogramm alle Zertifikate auf dem Computer, die Sie installiert haben. Wenn Sie diese Zertifikate entfernen möchten, müssen Sie sie manuell entfernen.
Wenn die Farm in eine Farm mit nur einem Computer verkleinert wird, müssen Sie alle Computer aus der Farm entfernen. Anschließend müssen Sie den Computer erneut hinzufügen, der Bestandteil der Farm sein soll.
Builddatum:
2013-07-25