Compartilhar via


New-ServiceFabricNodeConfiguration

Configura um nó para ingressar em um cluster do Service Fabric. Funciona para clusters de desenvolvimento e clusters do Azure.

Sintaxe

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

Description

O cmdlet New-ServiceFabricNodeConfiguration configura um nó para poder ser adicionado a um cluster do Service Fabric. Isso envolve a instalação do Service Fabric, se necessário, e, em seguida, o uso de informações de configuração extraídas do manifesto do cluster e, em seguida, cria as configurações necessárias para que o nó ingresse no cluster.

O nó ingressará no cluster assim que o Serviço de Host do Service Fabric for iniciado no computador host.

Para gerenciar clusters do Service Fabric, inicie sua sessão do Windows PowerShell usando a opção Executar como administrador.

Esse comando terá diferentes usos de parâmetros, dependendo do tipo de cluster ao qual essa operação é aplicada. Em todos os casos, esse comando é usado para adicionar um nó a um cluster. Se estiver usando um cluster autônomo, consulte o comando AddNode.

Exemplos

Exemplo 1: Configurar um cluster de desenvolvimento de cinco nós

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

Esse comando configura um cluster de desenvolvimento usando o manifesto DevEnv-FiveNodes.xml dos exemplos do Service Fabric. Esse manifesto configura um cluster do Service Fabric de cinco nós em seu computador de desenvolvimento.

Parâmetros

-BootstrapMSIPath

Especifica o caminho do arquivo de inicialização .msi. Este é o SDK do Service Fabric baixado do site do Service Fabric. Se você usar esse parâmetro, ocorrerá automaticamente uma atualização de auto-linha de base, quando uma atualização é configurada ou a malha é atualizada. Se -UsingFabricPackage estiver definido, isso deverá apontar para o arquivo CAB do Service Fabric em vez do arquivo .msi. O arquivo CAB do Service Fabric está disponível para download aqui.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClusterManifestPath

Especifica o caminho de um manifesto de cluster do Service Fabric, que é um arquivo XML. Exemplos desse arquivo podem ser vistos em exemplos do Service Fabric em "PublishProfiles". O cmdlet cria uma configuração de cluster com base no manifesto especificado.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FabricDataRoot

Especifica o caminho em que o runtime do Service Fabric armazena os dados internos necessários para operar um cluster.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FabricHostCredential

Especifica um objeto PSCredential para o Serviço de Host do Service Fabric. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FabricLogRoot

Especifica o caminho para os logs de rastreamento do Service Fabric.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FabricPackageRoot

Esse parâmetro é reservado para uso futuro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InfrastructureManifestPath

Especifica o caminho do manifesto da infraestrutura. Esse manifesto é usado para dar a cada nó uma visão geral do cluster. Por exemplo, a quantidade total de nós no cluster. No Azure, esse é o caminho para os arquivos .csdef e .cscfg.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MachineName

Especifica o computador que hospedará a configuração. Você pode usar o nome do computador ou o endereço IP do computador. Por exemplo:

-MachineName "192.168.1.1"

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveExistingConfiguration

Indica que esse cmdlet remove as configurações existentes. Essas configurações consistem em dados encontrados nas pastas apontadas por FabricDataRoot e FabricLogRoot.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunFabricHostServiceAsManual

Indica que o serviço Host do Fabric deve ser iniciado manualmente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UsingFabricPackage

Indica que as configurações de nó devem usar o pacote de runtime xcopy/CAB. Isso pode ser baixado no site do Service Fabric. Isso é usado quando o MSI não está instalado e estamos usando um pacote cliente para executar o cmdlet. O caminho para o pacote xcopy/CAB deve ser definido no parâmetro -BootstrapMSIPath.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object