Gerenciando farms e nós
Os cmdlets descritos nesta seção criam ou excluem os farms e os nós neles contidos.
Criando um novo farm do Service Bus for Windows Server
O cmdlet New-SBFarm cria um novo farm de nós do Service Bus for Windows Server. Para criar um farm com certificados gerados automaticamente use o formato a seguir:
New-SBFarm [-AdminGroup <String>] [-GatewayDBConnectionString <String>] [-HttpsPort <Int32>]
[-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>] [-MessageContainerDBConnectionString <String>]
[-RunAsAccount <String>] [-TcpPort <Int32>] -CertificateAutoGenerationKey <SecureString> -SBFarmDBConnectionString <String>
Para criar um farm com certificados personalizados use o formato a seguir:
New-SBFarm [-AdminGroup <String>] [-EncryptionCertificateThumbprint <String>] [-GatewayDBConnectionString
<String>] [-HttpsPort <Int32>] [-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>]
[-MessageContainerDBConnectionString <String>] [-RunAsAccount <String>] [-TcpPort <Int32>]
-FarmCertificateThumbprint <String> -SBFarmDBConnectionString <String>
Se ocorrer um erro ou se você for forçado a reinicializar durante a criação do farm, o banco de dados de gerenciamento do farm criado poderá ficar em um estado corrompido. Nesse caso, quando tentar ingressar em um farm, o processo poderá exibir um erro informando que o computador que você está tentando adicionar ao farm não faz parte de qualquer farm. Quando encontrar algum erro dessa natureza, será necessário remover o banco de dados de gerenciamento e recriá-lo antes de poder ingressar qualquer novo nó ao farm.
A tabela a seguir descreve as opções para este cmdlet.
| Opção | Efeito |
|---|---|
–SBFarmDBConnectionString <connectionstring> |
Representa uma cadeia de conexão do banco de dados de configuração. |
-Admingroup <adgroup> |
Especifica o grupo de usuários cujos membros recebem acesso administrativo aos bancos de dados no farm. O padrão é o grupo BuiltIn\Administradores no computador. |
-CertificateAutoGenerationKey <SecureString>] |
Especifica a chave usada pelo instalador para gerar o novo certificado SSL de serviços para proteger a comunicação entre os serviços e os seus clientes. |
-MessageContainerDBConnectionString <connstring> |
Especifica a cadeia de conexão da instância do banco de dados usada como o banco de dados do contêiner. |
-MessageBrokerPort <portno> |
Especifica a porta que será usada para a comunicação do agente de mensagem. O valor padrão é 9356. |
-HttpsPort <portno> |
Especifica a porta que será usada para a comunicação https. O valor padrão é 9355. |
-InternalPortRangeStart <portrange> |
Especifica o intervalo de portas que os nós do Service Bus for Windows Server no Malha do Windows usam para se comunicar entre si. O parâmetro portrange é um número de porta único que representa a primeira porta em um intervalo de seis portas consecutivas. |
-GatewayDBConnectionString <connstring> |
Especifica a cadeia de conexão da instância do banco de dados usada como o banco de dados do gateway. O banco de dados do gateway gerencia e faz o balanceamento de carga das solicitações de entrada. |
-TCPPort <portno> |
Especifica a porta que os nós do Service Bus for Windows Server usam para se comunicar entre si. O valor padrão é 9354. |
-EncryptionCertificateThumbprint <string> |
O certificado que é usado para proteger as cadeias de conexão SQL. Caso não seja fornecido, ele obterá o valor de SslCertificate. Representa o certificado de criptografia. |
-FarmCertificateThumbprint <string> |
O certificado que é usado para proteger o certificado. Não forneça este certificado se estiver fornecendo CertificateAutoGenerationKey para a geração automática de certificados. |
Adicionando um novo nó ao farm
O cmdlet Add-SBHost adiciona um nó ao farm existente. O cmdlet Add-SBHost tem o seguinte formato:
Add-SBHost [-CertificateAutogenerationKey <SecureString>] [-ExternalBrokerPort <Int32>] [-ExternalBrokerUrl <Uri>] -EnableFirewallRules <Boolean> -RunAsPassword <SecureString> -SBFarmDBConnectionString <String>
A tabela a seguir descreve as opções para este cmdlet.
| Opção | Efeito |
|---|---|
–SBFarmDBConnectionString <connectionstring> |
Especifica a cadeia de conexão da instância do SQL Server sendo adicionada como o banco de dados de gerenciamento do farm. |
-RunAsPassword <SecureString> |
Especifica a senha da conta de usuário em que os serviços estão sendo executados no farm. Se todas as máquinas em um farm compartilham a mesma conta de serviço e a política de segurança exige que a senha da conta do serviço seja alterada em intervalos regulares, é necessário realizar ações específicas em cada máquina do farm para poder continuar a adicionar e remover nós do farm. Consulte a seção intitulada Manipulando alterações de senhas do farm para esse procedimento. |
-CertificateAutoGenerationKey <SecureString>] |
Especifica a chave usada pelo farm para proteger os certificados gerados automaticamente. |
-EnableFirewallRules <Boolean> |
Se true, as regras de firewall serão ativadas no host. |
-ExternalBrokerPort <Int32> |
Representa a porta usada pelo Service Bus for Windows Server para a comunicação ExternalBroker. |
-ExternalBrokerUrl <Uri> |
Especifica um URI de ExternalBroker que diferencia maiúsculas e minúsculas. |
O programa de instalação gera automaticamente os seguintes certificados com base nas suas seleções quando adiciona o nó ao farm:
| Tipo de certificado | Nome | Emissor |
|---|---|---|
CA |
AppServerGeneratedSBCA |
|
FarmCertificate |
AppServerGeneratedSBCA |
AppServerGeneratedSBCA |
Removendo um nó de um farm
O cmdlet Remove-SBHost remove um nó do farm existente. Se o farm estiver em um estado interrompido quando você executar esse cmdlet, poderão ser gerados alguns erros ou avisos. Será possível ignorar esses erros ou avisos e executar Start-SBFarm após Remove-SBHost para que as alterações tenham efeito. Se o farm estiver em estado de execução, a execução de Start-SBFarm não é necessária.
Esse cmdlet tem o seguinte formato:
Remove-SBHost [-SBFarmDBConnectionString <string>] [-HostName <string>] [<CommonParameters>]
A tabela a seguir descreve as opções para este cmdlet.
| Opção | Efeito |
|---|---|
–SBFarmDBConnectionString <connectionstring> |
Especifica a cadeia de conexão da instância do SQL Server que está sendo removida do farm. Se você não fornecer esse parâmetro, o cmdlet utilizará a cadeia de conexão no registro. |
-HostName<String> |
Nome do host a ser removido. Se você não fornecer esse parâmetro, o host no qual o cmdlet é executado será removido. Observação Deve fornecer um HostName caso o host já não esteja disponível e você deseje limpar a configuração do farm. |
Se deseja renomear um computador que pertence a um farm, você deve usar este cmdlet para removê-lo do farm antes de renomeá-lo e, em seguida, adicioná-lo ao farm novamente usando o cmdlet Add-SBHost. Se esse cmdlet encontrar um erro de tempo limite, você ainda poderá tentar executar o cmdlet Add-SBHost para tentar adicioná-lo ao farm novamente. Se Add-SBHost for bem-sucedido, você pode ignorar o erro de tempo limite anterior.
Quando você sai de um farm, o desinstalador não remove os certificados que você instalou no computador. Caso deseje remover esses certificados, você deve removê-los manualmente.
Ao reduzir o farm para um farm em um único computador, você deverá remover todos os computadores do farm. Em seguida, você deverá adicionar novamente o computador que deseja que faça parte do farm.
Data da compilação:
2013-07-25