O cmdlet Connect-ServiceFabricCluster cria uma conexão com um cluster autônomo do Service Fabric que permite executar ações de gerenciamento para esse cluster.
Depois de se conectar a um cluster, você pode exibir as configurações da conexão usando o cmdlet Get-ServiceFabricClusterConnection.
Para gerenciar clusters do Service Fabric, inicie o Windows PowerShell usando a opção Executar como administrador opção.
Este comando se conecta a um cluster usando um certificado X.509.
Esse comando usa o recurso de splatting do Windows PowerShell para criar uma tabela de hash para parâmetros e, em seguida, os fornece ao cmdlet Connect-ServiceFabricCluster.
Exemplo 3: Conectar-se a um cluster gerenciado usando um certificado X.509
Nota: A conexão a um cluster gerenciado requer os módulos 'Az.ServiceFabric' e 'Az.Resources' do PowerShell para consultar impressões digitais de certificados de servidor.
Este comando primeiro consulta o recurso de cluster gerenciado para impressões digitais de certificado de servidor atual e, em seguida, se conecta ao cluster usando o certificado X509. Forneça o nome do grupo de recursos para o cluster gerenciado para recuperar informações de conexão, incluindo a ID de recurso completa para o cluster gerenciado. Consulte Conectar-se a um cluster gerenciado do Service Fabric.
Em seguida, esse comando se conecta a um cluster usando um certificado X.509.
Exemplo 4: Conectar-se a um cluster usando o Azure Ative Directory
Este comando se conecta a um cluster usando a autenticação do Azure Ative Directory (AAD).
Esse comando usa o recurso de splatting do Windows PowerShell para criar uma tabela de hash para parâmetros e, em seguida, os fornece ao cmdlet Connect-ServiceFabricCluster.
Exemplo 5: Conectar-se a um cluster protegido com uma conta de serviço gerenciada por grupo
Esse comando usa o recurso de splatting do Windows PowerShell para criar uma tabela de hash para parâmetros e, em seguida, os fornece ao cmdlet Connect-ServiceFabricCluster.
Exemplo 6: Conectar-se a um cluster protegido com contas de máquina
Este comando cria uma conexão com o cluster especificado.
Parâmetros
-AllowNetworkConnectionOnly
Indica que o cmdlet permite conectar-se ao cluster mesmo quando os serviços do sistema não respondem, desde que uma conexão de rede subjacente possa ser estabelecida.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-AuthTokenBufferSize
Ao conectar-se com AzureActiveDirectory, especifica o tamanho do buffer a ser alocado para aquisição de token de segurança.
Propriedades dos parâmetros
Tipo:
Int64
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-AzureActiveDirectory
Especifica que o Azure Ative Directory deve ser usado para autenticação e autorização.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Aad
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-CloudServiceDNSNames
Este parâmetro é apenas para uso interno.
Propriedades dos parâmetros
Tipo:
String[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Dsts
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-CloudServiceName
Este parâmetro é apenas para uso interno.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Dsts
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ClusterSpn
Especifica o nome da entidade de segurança do cluster a ser usado para a credencial do Windows.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Windows
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ConnectionEndpoint
Especifica uma matriz de pontos de extremidade de conexão para o cluster no formato ClusterAddress: ClientConnectionEndpoint, onde ClusterAddress é o endereço IPv4, endereço IPv6 ou FQDN (nome de domínio totalmente qualificado) do nó do cluster ao qual se conectar e ClientConnectionEndpoint é a porta de conexão do cliente especificada no manifesto do cluster.
Coloque os endereços IPv6 entre colchetes ([]).
Os pontos de extremidade válidos têm a seguinte forma:
Especifica o período de tempo limite, em segundos, para a operação.
Propriedades dos parâmetros
Tipo:
Double
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-DSTS
Este parâmetro é apenas para uso interno.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Dsts
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-FindType
Especifica o tipo de FindValue para pesquisar certificados no armazenamento de certificados.
Os seguintes tipos de filtro são suportados:
FindByThumbprint.
Encontre o certificado por impressão digital do certificado.
FindBySubjectName.
Pesquisar certificado no armazenamento de certificados por nome distinto de entidade ou nome comum, quando o nome distinto da entidade é fornecido em FindValue, o nome da entidade no certificado deve ser codificado na codificação ASN devido a uma restrição na API de criptografia nativa do Windows.
Não há essa restrição quando o nome comum é fornecido em FindValue.
Especifica o valor do filtro para pesquisar um certificado no armazenamento de certificados.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
X509
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-GetMetadata
Ao conectar-se com AzureActiveDirectory, recupera anonimamente os metadados usados para aquisição de token e não tenta nenhuma autenticação.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Aad
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-HealthOperationTimeoutInSec
Especifica o período de tempo limite, em segundos, para o envio de relatórios de integridade.
Quando uma operação de integridade expira ou falha com um erro de comunicação, o cliente de integridade tenta novamente a operação internamente.
Propriedades dos parâmetros
Tipo:
Double
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-HealthReportRetrySendIntervalInSec
Especifica o intervalo, em segundos, no qual o cliente de integridade tenta enviar novamente os relatórios que não puderam ser enviados ou persistiram no repositório de integridade. O valor mínimo suportado é 1 segundo.
Propriedades dos parâmetros
Tipo:
Double
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-HealthReportSendIntervalInSec
Especifica o intervalo, em segundos, no qual o cliente de integridade envia os relatórios de integridade para o repositório de integridade.
Se definido como 0, o cliente de saúde enviará os relatórios imediatamente.
Propriedades dos parâmetros
Tipo:
Double
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Interactive
Indica se o cmdlet opera interativamente.
Propriedades dos parâmetros
Tipo:
Boolean
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Dsts
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-KeepAliveIntervalInSec
Especifica o período keep-alive da conexão em segundos.
Esse intervalo impede que uma conexão seja encerrada devido à inatividade durante operações executadas de forma assíncrona.
Propriedades dos parâmetros
Tipo:
Double
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-MetaDataEndpoint
Este parâmetro é apenas para uso interno.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Dsts
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-PartitionLocationCacheLimit
Especifica o número de partições armazenadas em cache para resolução do serviço.
O valor padrão é 0, o que significa que não há limite.
Propriedades dos parâmetros
Tipo:
Int64
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-SecurityToken
Ao se conectar com AzureActiveDirectory, o token de segurança especificado é usado diretamente para autenticação e autorização, em vez de executar o login de usuário interativo.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Aad
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ServerCertThumbprint
Especifica uma matriz das impressões digitais esperadas para o lado do cluster.
Essas impressões digitais são usadas para autenticar que o cmdlet se conecta ao ponto de extremidade do cluster correto durante a autenticação mútua x509 ou do Azure Ative Directory.
Propriedades dos parâmetros
Tipo:
String[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
X509
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Dsts
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Aad
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ServerCommonName
Especifica uma matriz dos nomes comuns esperados para o lado do cluster.
Esses nomes são usados para autenticar que o cmdlet se conecta ao ponto de extremidade do cluster correto durante a autenticação mútua x509 ou do Azure Ative Directory.
Propriedades dos parâmetros
Tipo:
String[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
X509
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Dsts
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
Aad
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-ServiceChangePollIntervalInSec
Especifica o intervalo, em segundos, no qual o cliente de malha sonda as alterações de serviço.
Esse intervalo é usado pelo modelo antigo de notificações de alteração de endereço de serviço baseadas em sondagem.
Propriedades dos parâmetros
Tipo:
Double
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-SkipChecks
Indica ignorar as verificações de validação da capacidade de resposta do serviço do sistema ao se conectar ao cluster.
Propriedades dos parâmetros
Tipo:
Boolean
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-StoreLocation
Especifica o local de armazenamento de um certificado.
Os valores aceitáveis para este parâmetro são:
CurrentUser
Máquina local
Propriedades dos parâmetros
Tipo:
StoreLocation
Default value:
None
Valores aceites:
CurrentUser, LocalMachine
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
X509
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-StoreName
Especifica o nome do armazenamento de certificados para carregar o certificado do cliente.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
X509
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-TimeoutSec
Especifica o período de tempo limite, em segundos, para a operação.
Propriedades dos parâmetros
Tipo:
Int32
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
(All)
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-WindowsCredential
Indica que o cmdlet usa credenciais do Windows para se conectar a um cluster do Service Fabric.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
Windows
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-X509Credential
Indica que o cmdlet usa um certificado x509 para executar a autenticação mútua com um cluster do Service Fabric.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
X509
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.