New-SBFarm

Letzte Aktualisierung: März 2014

New-SBFarm

Sie können dieses Cmdlet zum Erstellen einer neuen Service Bus for Windows Server-Farm verwenden.

Syntax

Parameter Set: AutoCert
New-SBFarm -CertificateAutoGenerationKey <SecureString> -SBFarmDBConnectionString <String> [-AdminApiCredentials <PSCredential> ] [-AdminGroup <String> ] [-AmqpPort <Int32> ] [-AmqpsPort <Int32> ] [-FarmDns <String> ] [-GatewayDBConnectionString <String> ] [-HttpsPort <Int32> ] [-InternalPortRangeStart <Int32> ] [-MessageBrokerPort <Int32> ] [-MessageContainerDBConnectionString <String> ] [-RPHttpsPort <Int32> ] [-RunAsAccount <String> ] [-TcpPort <Int32> ] [-TenantApiCredentials <PSCredential> ] [ <CommonParameters>]

Parameter Set: CustomCert
New-SBFarm -FarmCertificateThumbprint <String> -SBFarmDBConnectionString <String> [-AdminApiCredentials <PSCredential> ] [-AdminGroup <String> ] [-AmqpPort <Int32> ] [-AmqpsPort <Int32> ] [-EncryptionCertificateThumbprint <String> ] [-FarmDns <String> ] [-GatewayDBConnectionString <String> ] [-HttpsPort <Int32> ] [-InternalPortRangeStart <Int32> ] [-MessageBrokerPort <Int32> ] [-MessageContainerDBConnectionString <String> ] [-RPHttpsPort <Int32> ] [-RunAsAccount <String> ] [-TcpPort <Int32> ] [-TenantApiCredentials <PSCredential> ] [ <CommonParameters>]

Detaillierte Beschreibung

Führen Sie New-SBFarm aus, um eine neue Service Bus for Windows Server-Farm zu erstellen. Dies ist der erste Schritt, der erforderlich ist, um erste Schritte mit Service Bus for Windows Server auszuführen. Eine Farm ist eine Service Bus for Windows Server-Konfiguration, die in einer Farmverwaltungsdatenbank gespeichert ist. Sie umfasst die Einstellungen, die für Service Bus for Windows Server erforderlich sind, z. B. Datenbanken zum Speichern von Einstellungen sowie Nachrichten und Ports für die externe Verwendung mit Clients oder die interne Verwendung zwischen den Hosts der Farm.

Für die Parameter FarmCertificateThumbprint und EncryptionCertificateThumbprint (für SSL) erwartet das New-SBFarm -Cmdlet, dass eine Zeichenfolge übergeben wird, in der der Fingerabdruck des Zertifikats, das Sie verwenden möchten, enthalten ist. Diese Parameter werden benötigt, wenn Sie planen, Ihre eigenen Zertifikate zu verwenden – die Zertifikate müssen im Zertifikatspeicher 'LocalMachine' vorhanden sein, bevor Sie New-SBFarm.

Wenn während einer Farmerstellung ein Fehler auftritt oder Sie zu einem Neustart gezwungen sind, weisen die erstellten Datenbanken ggf. 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 Datenbanken löschen und dann erneut erstellen, bevor Sie der Farm neue Knoten hinzufügen können.

Sie können eine Servicebus-Farm erstellen, die über das Windows Azure Pack-Verwaltungsportal verwaltet wird. Zum Aktivieren dieser Konfiguration müssen Sie die grundlegenden Authentifizierungseinstellungen zwischen dem Servicebus-Ressourcenanbieter und dem Windows Azure Pack-Portal angeben. Dies beinhaltet Einstellungen für die Verwaltungs-API sowie für die Mandanten-API.

Parameter

-AdminApiCredentials<PSCredential>

Legt die Anmeldeinformationen des Ressourcenanbieters fest. Der Ressourcenanbieter ist eine Komponente, die die Verwaltungs-API für das Portal bereitstellt. Es gibt zwei Service Bus-Verwaltungsportale: das Administratorenportal (das eine Sammlung von Ressourcenanbieter-APIs für die Farmverwaltung zur Verfügung stellt) und das Mandantenportal (das Azure-Verwaltungsportal). Verwenden Sie diese Anmeldeinformationen, wenn Sie die Serverfarm manuell installieren und mit dem Administratorenportal verbinden.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-AdminGroup<String>

Stellt die Gruppe "Administratoren" dar.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	BUILTIN\Administrators
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-AmqpPort<Int32>

Dieser optionale Parameter setzt den AMQP-Port.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-AmqpsPort<Int32>

Dieser optionale Parameter setzt den AMQP-SSL-Port.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-CertificateAutoGenerationKey<SecureString>

Diese Passphrase ist für die automatische Zertifikatgenerierung erforderlich. Dieser Parameter ist obligatorisch, wenn Zertifikate automatisch generiert werden sollen.

Aliase	keine
Erforderlich?	true
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-EncryptionCertificateThumbprint<String>

Das Zertifikat wird verwendet, um die SQL-Verbindungszeichenfolge zu schützen. Wenn kein Zertifikat verfügbar ist, wird der Wert von SslCertificate verwendet. Stellt das Verschlüsselungszertifikat dar.

Für die beiden Parameter FarmCertificateThumbprint und EncryptionCertificateThumbprint (für SSL) erwartet das New-SBFarm -Cmdlet, dass eine Zeichenfolge übergeben wird, in der der Fingerabdruck des Zertifikats, das Sie verwenden möchten, enthalten ist.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-FarmCertificateThumbprint<String>

Stellt das Zertifikat dar, 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.

Für die beiden Parameter FarmCertificateThumbprint und EncryptionCertificateThumbprint (für SSL) erwartet das New-SBFarm -Cmdlet, dass eine Zeichenfolge übergeben wird, in der der Fingerabdruck des Zertifikats, das Sie verwenden möchten, enthalten ist.

Aliase	keine
Erforderlich?	true
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-FarmDns<String>

Das DNS-Präfix, das allen Serverfarmknoten zugeordnet ist. Dieses Cmdlet wird verwendet, wenn ein Administrator eine Serverfarm registriert. Der Serverfarm-Knotenwert wird zurückgegeben, wenn Sie das Cmdlet Get-SBClientConfiguration aufrufen, um eine Verbindungszeichenfolge anzufordern.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-GatewayDBConnectionString<String>

Stellt eine Verbindungszeichenfolge der Gatewaydatenbank dar. Wenn sie nicht übergeben wird, wird sie in der gleichen SQL Server-Instanz mithilfe von "SBFarmDBConnectionString" mit dem Standardnamen "SBGatewayDatabase" erstellt.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	SBGatewayDatabase
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-HttpsPort<Int32>

Stellt den Port dar, den Service Bus for Windows Server für die HTTPS-Kommunikation verwendet.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	9355
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-InternalPortRangeStart<Int32>

Stellt den Anfang des Portbereichs dar, den Service Bus for Windows Server für interne Kommunikationszwecke verwendet.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	9000-004
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-MessageBrokerPort<Int32>

Stellt den Port dar, den Service Bus for Windows Server für die MessageBroker-Kommunikation verwendet.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	9356
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-MessageContainerDBConnectionString<String>

Stellt eine Verbindungszeichenfolge des Nachrichtencontainers dar. Wenn sie nicht übergeben wird, wird sie in der gleichen SQL Server-Instanz mithilfe von "SBFarmDBConnectionString" mit dem Standardnamen "SBMessageContainer01" erstellt.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	SBMessageContainer01
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-RPHttpsPort<Int32>

Dieser optionale Parameter gibt die Porteinstellung für den Ressourcenanbieter an. Dieser Port wird vom Portal für den Zugriff auf die Servicebus-Farm verwendet.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-RunAsAccount<String>

Stellt das Konto dar, unter dem der Dienst ausgeführt wird. Dieses Konto muss ein Domänenkonto sein.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	The account under which configuration is run
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-SBFarmDBConnectionString<String>

Stellt eine Verbindungszeichenfolge der Service Bus for Windows Server-Datenbank dar.

Aliase	keine
Erforderlich?	true
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-TcpPort<Int32>

Stellt den Port dar, den Service Bus for Windows Server für TCP verwendet.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	9354
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-TenantApiCredentials<PSCredential>

Legt die Ressourcenanbieter-Anmeldeinformationen für das Mandantenportal fest. Der Ressourcenanbieter ist eine Komponente, die die Verwaltungs-API für das Portal bereitstellt. Es gibt zwei Service Bus-Verwaltungsportale: das Administratorenportal (das eine Sammlung von Ressourcenanbieter-APIs für die Farmverwaltung zur Verfügung stellt) und das Mandantenportal (das Azure-Verwaltungsportal). Verwenden Sie diese Anmeldeinformationen, wenn Sie die Serverfarm manuell installieren und mit dem Mandantenportal verbinden.

Aliase	keine
Erforderlich?	false
Position?	named
Standardwert	keine
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die Sie per Piping an das Cmdlet übergeben können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

Beispiele

Beispiel 1

Erstellen einer neuen Service Bus for Windows Server-Farm mit Standardeinstellungen. Die Farm verwendet die SQLExpress-Datenbank des lokalen Hosts und erstellt drei Datenbanken ("ManagementDB", "GatewayDB" und "MessageContainer1").

PS C:\> $mycert=ConvertTo-SecureString -string myPassword1 -force –AsPlainText; New-SBFarm  -SBFarmDBConnectionString 'Data Source=localhost\sqlexpress;Integrated Security=True' -CertificateAutoGenerationKey $mycert

Beispiel 2

Erstellen einer neuen Service Bus for Windows Server-Farm, in der die Verwaltungs- und Gatewaydatenbanken auf dem MySQLServer-Server und die anfängliche Nachrichtencontainerdatenbank auf dem myDedicatedMessagingSQLServer-Server gespeichert werden. Die Service Bus for Windows Server Services werden unter dem Domänenkonto "myServiceAccount" ausgeführt, und der Active Directory-Benutzergruppe "myAdminsGroup" werden Administratorberechtigungen erteilt.

PS C:\> $mycert=ConvertTo-SecureString -string myPassword1 -force –AsPlainText; New-SBFarm -SBFarmDBConnectionString 'Data Source=mySQLServer;Integrated Security=True' –RunAsAccount myServiceAccount –AdminGroup myAdminsGroup –MessageContainerDBConnectionString 'Data Source=myDedicatedMessagingSQLServer;Integrated Security=True' –CertificateAutoGenerationKey $mycert

Service Bus 1.0 MSDN Community Forum