Connect-ServiceFabricCluster
Cria uma ligação a um cluster de Tecido de Serviço.
Sintaxe
Connect-ServiceFabricCluster
[[-ConnectionEndpoint] <String[]>]
[-AllowNetworkConnectionOnly]
[-ConnectionInitializationTimeoutInSec <Double>]
[-HealthOperationTimeoutInSec <Double>]
[-HealthReportSendIntervalInSec <Double>]
[-HealthReportRetrySendIntervalInSec <Double>]
[-KeepAliveIntervalInSec <Double>]
[-ServiceChangePollIntervalInSec <Double>]
[-PartitionLocationCacheLimit <Int64>]
[-AuthTokenBufferSize <Int64>]
[-SkipChecks <Boolean>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Connect-ServiceFabricCluster
[-ConnectionEndpoint] <String[]>
[-AllowNetworkConnectionOnly]
[-WindowsCredential]
[-ClusterSpn <String>]
[-ConnectionInitializationTimeoutInSec <Double>]
[-HealthOperationTimeoutInSec <Double>]
[-HealthReportSendIntervalInSec <Double>]
[-HealthReportRetrySendIntervalInSec <Double>]
[-KeepAliveIntervalInSec <Double>]
[-ServiceChangePollIntervalInSec <Double>]
[-PartitionLocationCacheLimit <Int64>]
[-AuthTokenBufferSize <Int64>]
[-SkipChecks <Boolean>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Connect-ServiceFabricCluster
[-ConnectionEndpoint] <String[]>
[-AllowNetworkConnectionOnly]
[-X509Credential]
[-ServerCommonName <String[]>]
[-ServerCertThumbprint <String[]>]
-FindType <X509FindType>
-FindValue <String>
[-StoreLocation <StoreLocation>]
[-StoreName <String>]
[-ConnectionInitializationTimeoutInSec <Double>]
[-HealthOperationTimeoutInSec <Double>]
[-HealthReportSendIntervalInSec <Double>]
[-HealthReportRetrySendIntervalInSec <Double>]
[-KeepAliveIntervalInSec <Double>]
[-ServiceChangePollIntervalInSec <Double>]
[-PartitionLocationCacheLimit <Int64>]
[-AuthTokenBufferSize <Int64>]
[-SkipChecks <Boolean>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Connect-ServiceFabricCluster
[-ConnectionEndpoint] <String[]>
[-AllowNetworkConnectionOnly]
[-ServerCommonName <String[]>]
[-ServerCertThumbprint <String[]>]
[-DSTS]
-MetaDataEndpoint <String>
[-CloudServiceName <String>]
[-CloudServiceDNSNames <String[]>]
[-ConnectionInitializationTimeoutInSec <Double>]
[-HealthOperationTimeoutInSec <Double>]
[-HealthReportSendIntervalInSec <Double>]
[-HealthReportRetrySendIntervalInSec <Double>]
[-KeepAliveIntervalInSec <Double>]
[-ServiceChangePollIntervalInSec <Double>]
[-PartitionLocationCacheLimit <Int64>]
[-AuthTokenBufferSize <Int64>]
[-Interactive <Boolean>]
[-SkipChecks <Boolean>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Connect-ServiceFabricCluster
[-ConnectionEndpoint] <String[]>
[-AllowNetworkConnectionOnly]
[-ServerCommonName <String[]>]
[-ServerCertThumbprint <String[]>]
[-AzureActiveDirectory]
[-SecurityToken <String>]
[-GetMetadata]
[-ConnectionInitializationTimeoutInSec <Double>]
[-HealthOperationTimeoutInSec <Double>]
[-HealthReportSendIntervalInSec <Double>]
[-HealthReportRetrySendIntervalInSec <Double>]
[-KeepAliveIntervalInSec <Double>]
[-ServiceChangePollIntervalInSec <Double>]
[-PartitionLocationCacheLimit <Int64>]
[-AuthTokenBufferSize <Int64>]
[-SkipChecks <Boolean>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
O cmdlet Connect-ServiceFabricCluster cria uma ligação a um cluster de tecido de serviço autónomo que lhe permite executar ações de gestão para esse cluster. Depois de ligar a um cluster, pode visualizar as definições da ligação utilizando o cmdlet Get-ServiceFabricClusterConnection .
Para gerir os clusters de Tecido de Serviço, comece Windows PowerShell utilizando a opção De execução como administrador.
Exemplos
Exemplo 1: Ligar a um cluster
PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint "ServiceFabric01.ContosoCloudApp.net:19000"
Este comando cria uma ligação ao cluster especificado.
Exemplo 2: Ligar a um cluster usando um certificado X.509
PS C:\> $ConnectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
X509Credential = $True
StoreLocation = 'CurrentUser'
StoreName = "MY"
ServerCommonName = "mycluster.cloudapp.net"
FindType = 'FindByThumbprint'
FindValue = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs
Este comando liga-se a um cluster utilizando um certificado X.509. Este comando utiliza a função de salpicos de Windows PowerShell para criar uma tabela de haxixe para parâmetros e, em seguida, fornece-os ao cmdlet Connect-ServiceFabricCluster.
Exemplo 3: Conecte-se a um cluster gerido usando um certificado X.509
PS C:\> $resourceGroup = 'mycluster'
PS C:\> $managedCluster = Get-AzServiceFabricManagedCluster -ResourceGroupName $resourceGroup
PS C:\> $ConnectArgs = @{
ConnectionEndpoint = "$($managedCluster.Fqdn):$($managedCluster.ClientConnectionPort)"
X509Credential = $true
StoreLocation = 'CurrentUser'
StoreName = "MY"
ServerCertThumbprint = (Get-AzResource -ResourceId $managedCluster.Id).Properties.clusterCertificateThumbprints
FindType = 'FindByThumbprint'
FindValue = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs
Nota: A ligação a um cluster gerido requer módulos PowerShell 'Az.ServiceFabric' e 'Az.Resources' para consultar as impressões digitais do certificado do servidor.
Este comando geriu primeiro o recurso de cluster para as impressões digitais do certificado do servidor atual e, em seguida, conecta-se ao cluster usando o certificado X509. Fornecer o nome do grupo de recursos para o cluster gerido para obter informações de conexão, incluindo o id completo de recursos para o cluster gerido. Consulte o conjunto de gestão de tecidos de serviço.
Este comando liga-se então a um cluster utilizando um certificado X.509.
Exemplo 4: Ligar-se a um cluster utilizando o Azure Ative Directory
PS C:\> $ConnectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
AzureActiveDirectory = $True
ServerCertThumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs
Este comando liga-se a um cluster utilizando a autenticação do Azure Ative Directory (AAD). Este comando utiliza a função de salpicos de Windows PowerShell para criar uma tabela de haxixe para parâmetros e, em seguida, fornece-os ao cmdlet Connect-ServiceFabricCluster.
Exemplo 5: Ligar a um cluster protegido com uma conta de serviço gerida por grupo
PS C:\> $ConnectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
WindowsCredential = $True
ClusterSpn = 'ServiceFabric/MyCluster.MyDomain.MyOrg'
}
PS C:\> Connect-ServiceFabricCluster @connectArgs
Este comando utiliza a função de salpicos de Windows PowerShell para criar uma tabela de haxixe para parâmetros e, em seguida, fornece-os ao cmdlet Connect-ServiceFabricCluster.
Exemplo 6: Ligar a um cluster protegido com contas de máquina
PS C:\> $connectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
WindowsCredential = $True
}
PS C:\> Connect-ServiceFabricCluster @connectArgs
Este comando liga-se a um cluster protegido com contas de máquina.
Exemplo 7: Ligar-se a um cluster sem as verificações primárias
PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint -SkipChecks $True "ServiceFabric01.ContosoCloudApp.net:19000"
Este comando cria uma ligação ao cluster especificado.
Parâmetros
-AllowNetworkConnectionOnly
Indica que o cmdlet permite a ligação ao cluster mesmo quando os serviços do sistema não respondem enquanto uma ligação de rede subjacente puder ser estabelecida.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-AuthTokenBufferSize
Ao ligar-se com a AzureActiveDirectory, especifica o tamanho do tampão a atribuir para aquisição de fichas de segurança.
Tipo: | Int64 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-AzureActiveDirectory
Especifica que o Azure Ative Directory deve ser utilizado para autenticação e autorização.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-CloudServiceDNSNames
Este parâmetro é apenas para uso interno.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-CloudServiceName
Este parâmetro é apenas para uso interno.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ClusterSpn
Especifica o nome principal de segurança do cluster para usar para a credencial do Windows.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ConnectionEndpoint
Especifica um conjunto de pontos finais de ligação para o cluster no formato ClusterAddress: ClientConnectionEndpoint, onde o ClusterAddress é o endereço IPv4, endereço IPv6 ou nome de domínio totalmente qualificado (FQDN) do nó de cluster a que se conecta e ClientConnectionEndpoint é a porta de ligação ao cliente especificada no manifesto do cluster. Enclose os endereços IPv6 em parênteses quadrados ([]). Os pontos finais válidos têm o seguinte formulário:
IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint
Tipo: | String[] |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ConnectionInitializationTimeoutInSec
Especifica o período de tempo de ício, em segundos, para a operação.
Tipo: | Double |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DSTS
Este parâmetro é apenas para uso interno.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-FindType
Especifica o tipo de FindValue para o certificado de pesquisa na loja de certificados. São suportados os seguintes tipos de filtro:
- Encontre a Impressão DeThumb. Encontre o certificado por impressão digital de certificado.
- FindBySubjectName. Certificado de pesquisa na loja de certificados por nome ou nome comum, quando o nome distinto do sujeito é fornecido no FindValue, o nome do sujeito no certificado deve ser codificado na codificação ASN devido a uma restrição na API cripto do Windows nativo. Não existe tal restrição quando o nome comum é fornecido no FindValue.
- FindBySubjectDistinguishedName
- FindByIssuerName
- FindByIssuerDistinguishedName
- FindBySerialNumber
- FindByTimeValid
- FindByTimeNotYetValid
- FindByTimeExpired
- FindByTemplateName
- FindByApplicationPolicy
- Localizar A Política de FindByCertate
- FindByExtension
- FindByKeyUsage
- FindBySubjectKeyIdentifier
Tipo: | X509FindType |
Valores aceites: | FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-FindValue
Especifica o valor do filtro para pesquisar um certificado na loja de certificados.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-GetMetadata
Ao ligar-se ao AzureActiveDirectory, recupera anonimamente os metadados utilizados para a aquisição de token e não tenta qualquer autenticação.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-HealthOperationTimeoutInSec
Especifica o período de tempo de ício, em segundos, para o envio de relatórios de saúde. Quando uma operação de saúde acaba ou falha com um erro de comunicação, o cliente de saúde retriu internamente a operação.
Tipo: | Double |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-HealthReportRetrySendIntervalInSec
Especifica o intervalo, em segundos, em que o cliente de saúde recauchutado enviando os relatórios que não foram enviados ou que persistem na loja de saúde. O valor mínimo suportado é de 1 segundo.
Tipo: | Double |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-HealthReportSendIntervalInSec
Especifica o intervalo, em segundos, para o qual o cliente de saúde envia os relatórios de saúde para a loja de saúde. Se for definido para 0, o cliente de saúde enviará os relatórios imediatamente.
Tipo: | Double |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Interactive
Indica se o cmdlet funciona interativamente.
Tipo: | Boolean |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-KeepAliveIntervalInSec
Especifica o período de manutenção da ligação em segundos. Este intervalo impede que a ligação seja interrompida devido à inatividade durante as operações que funcionam assíncronamente.
Tipo: | Double |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MetaDataEndpoint
Este parâmetro é apenas para uso interno.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-PartitionLocationCacheLimit
Especifica o número de divisórias em cache para resolução de serviço. O valor predefinido é 0, o que significa que não há limite.
Tipo: | Int64 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SecurityToken
Ao ligar-se ao AzureActiveDirectory, o token de segurança especificado é utilizado diretamente para autenticação e autorização em vez de realizar login de utilizador interativo.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ServerCertThumbprint
Especifica uma matriz das impressões digitais esperadas para o lado do cluster. Estas impressões digitais são utilizadas para autenticar que o cmdlet se conecta ao ponto final do cluster correto durante a autenticação mútua x509 ou Azure Ative Directory.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ServerCommonName
Especifica uma matriz dos nomes comuns esperados para o lado do cluster. Estes nomes são utilizados para autenticar que o cmdlet se conecta ao ponto final do cluster correto durante a autenticação mútua x509 ou Azure Ative Directory.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ServiceChangePollIntervalInSec
Especifica o intervalo, em segundos, no qual o cliente de tecido sonda para alterações de serviço. Este intervalo é utilizado por um modelo antigo de notificações de alteração de endereço de serviço baseado em sondagens.
Tipo: | Double |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SkipChecks
Indica contornar as verificações de capacidade de resposta do serviço do sistema ao ligar-se ao cluster.
Tipo: | Boolean |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-StoreLocation
Especifica a localização da loja de um certificado. Os valores aceitáveis para este parâmetro são:
- ActualUser
- LocalMachine
Tipo: | StoreLocation |
Valores aceites: | CurrentUser, LocalMachine |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-StoreName
Especifica o nome da loja de certificados para carregar o certificado do cliente.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-TimeoutSec
Especifica o período de tempo de ício, em segundos, para a operação.
Tipo: | Int32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WindowsCredential
Indica que o cmdlet utiliza credenciais do Windows para ligar a um cluster de Tecido de Serviço.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-X509Credential
Indica que o cmdlet utiliza um certificado x509 para efetuar a autenticação mútua com um cluster de Tecido de Serviço.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
None
Saídas
System.Object