New-SBFarm

New-SBFarm

Este cmdlet se puede usar para crear una nueva granja de servidores de Service Bus para Windows Server.

Sintaxis

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>]

Descripción detallada

Ejecute New-SBFarm para crear una granja de Service Bus para Windows Server nueva. Se trata del primer paso necesario para comenzar a usar Service Bus para Windows Server. Una granja de servidores es una configuración de Service Bus para Windows Server que se almacena en una base de datos de administración de granjas de servidores. Incluye las opciones de configuración que Service Bus para Windows Server necesita, tales como las bases de datos que se deben usar para almacenar la configuración, así como los mensajes y los puertos que se deben usar externamente con los clientes o internamente entre los hosts de la granja de servidores.

Para los parámetros FarmCertificateThumbprint y EncryptionCertificateThumbprint (para SSL), el cmdlet New-SBFarm espera que se pase una cadena con la huella digital del certificado que desea usar. Estos parámetros son necesarios si planea usar sus propios certificados. Los certificados deben estar en el almacén de certificados LocalMachine antes de llamar a New-SBFarm.

Si se produce un error o fuera necesario reiniciar el sistema durante la creación de la granja de servidores, las bases de datos creadas pueden quedar dañadas. En este caso, al intentar unir una granja de servidores, es posible que el proceso muestre un error que indica que el equipo que intenta agregar a la granja de servidores no forma parte de ninguna granja. Si se produce este tipo de error, deberá descartar las bases de datos y volver a crearlas antes de poder unir nodos nuevos a la granja de servidores.

Puede crear una granja CmdLets que se administre mediante el portal de administración del paquete de Windows Azure. Para activar esta configuración, debe especificar la configuración básica de autenticación entre el proveedor de recursos de CmdLets y el portal del paquete de Windows Azure. Aquí se incluye la configuración de la API de administración y la API de inquilinos.

Parámetros

-AdminApiCredentials<PSCredential>

Establece las credenciales del proveedor de recursos. El proveedor de recursos es un componente que expone la API de administración en el portal. Hay dos portales de administración de Service Bus; el portal de administración (que proporciona un conjunto de API del proveedor de recursos para la administración de la granja), y el portal de inquilinos (que es el Portal de administración de Azure). Use estas credenciales cuando instale manualmente la granja de servidores y se conecte al portal de administración.

-AdminGroup<String>

Representa el grupo de administración.

-AmqpPort<Int32>

Este parámetro opcional establece el puerto AMQP.

-AmqpsPort<Int32>

Este parámetro opcional establece el puerto AMQP SSL.

-CertificateAutoGenerationKey<SecureString>

Esta frase de contraseña es obligatoria para la generación automática de certificados. Este parámetro es obligatorio si desea que los certificados se generen automáticamente.

-EncryptionCertificateThumbprint<String>

Este certificado se utiliza para asegurar las cadenas de conexión SQL. Si no se proporciona, obtendrá el valor de SslCertificate. Representa el certificado de cifrado.

Para los parámetros FarmCertificateThumbprint y EncryptionCertificateThumbprint (para SSL), el cmdlet New-SBFarm espera que se pase una cadena con la huella digital del certificado que desea usar.

-FarmCertificateThumbprint<String>

Representa el certificado que se usa para la seguridad de este. No proporcione este certificado si proporciona el valor CertificateAutoGenerationKey para la generación automática de certificados.

Para los parámetros FarmCertificateThumbprint y EncryptionCertificateThumbprint (para SSL), el cmdlet New-SBFarm espera que se pase una cadena con la huella digital del certificado que desea usar.

-FarmDns<String>

Prefijo de DNS asignado a todos los nodos de la granja de servidores. Este cmdlet se usa cuando un administrador registra una granja de servidores. El valor del nodo de la granja de servidores se devuelve cuando se llama al cmdlet Get-SBClientConfiguration para solicitar una cadena de conexión.

-GatewayDBConnectionString<String>

Representa una cadena de conexión de la base de datos de puerta de enlace. Si no se transfiere, se creará en el mismo SQL Server mediante SBFarmDBConnectionString con el nombre predeterminado “SBGatewayDatabase”.

-HttpsPort<Int32>

Representa el puerto que Service Bus para Windows Server usa para la comunicación HTTPS.

-InternalPortRangeStart<Int32>

Representa el inicio del intervalo de puertos que Service Bus para Windows Server usa para la comunicación interna.

-MessageBrokerPort<Int32>

Representa el puerto que Service Bus para Windows Server usa para la comunicación MessageBroker.

-MessageContainerDBConnectionString<String>

Representa una cadena de conexión del contenedor de mensajes. Si no se transfiere, se creará en el mismo SQL Server mediante SBFarmDBConnectionString con el nombre predeterminado “SBMessageContainer01”.

-RPHttpsPort<Int32>

Este parámetro opcional especifica la configuración de puerto del proveedor de recursos. El portal utiliza este puerto para acceder a la granja de CmdLets.

-RunAsAccount<String>

Representa la cuenta bajo la que se ejecuta el servicio. Esta cuenta debe ser una cuenta de dominio.

-SBFarmDBConnectionString<String>

Representa una cadena de conexión de la base de datos de Service Bus para Windows Server.

-TcpPort<Int32>

Representa el puerto que Service Bus para Windows Server usa para la comunicación TCP.

-TenantApiCredentials<PSCredential>

Establece las credenciales del proveedor de recursos para el portal de inquilinos. El proveedor de recursos es un componente que expone la API de administración en el portal. Hay dos portales de administración de Service Bus; el portal de administración (que proporciona un conjunto de API del proveedor de recursos para la administración de la granja), y el portal de inquilinos (que es el Portal de administración de Azure). Use estas credenciales cuando instale manualmente la granja de servidores y se conecte al portal de inquilinos.

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

Ejemplos

Ejemplo 1

Cree una nueva granja de servidores de Service Bus para Windows Server con la configuración predeterminada. La granja de servidores usará la base de datos SQLExpress del host local y creará tres bases de datos (ManagementDB, GatewayDB and MessageContainer1).

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

Ejemplo 2

Cree una nueva granja de servidores de Service Bus para Windows Server en la que las bases de datos de administración y puerta de enlace se colocan en el servidor MySQLServer y la base de datos de contenedores de mensajes inicial se coloca en el servidor myDedicatedMessagingSQLServer. Los servicios Service Bus para Windows Server se ejecutarán bajo la cuenta de dominio myServiceAccount y los permisos de administrador se conceden al grupo de usuarios myAdminsGroup de Active Directory.

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