Connect-ServiceFabricCluster

Referência

Módulo:: ServiceFabric

Cria uma ligação a um cluster de Tecido de Serviço.

Syntax

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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuthTokenBufferSize

Ao ligar-se com a AzureActiveDirectory, especifica o tamanho do tampão a atribuir para aquisição de fichas de segurança.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AzureActiveDirectory

Especifica que o Azure Ative Directory deve ser utilizado para autenticação e autorização.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudServiceDNSNames

Este parâmetro é apenas para uso interno.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudServiceName

Este parâmetro é apenas para uso interno.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterSpn

Especifica o nome principal de segurança do cluster para usar para a credencial do Windows.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionInitializationTimeoutInSec

Especifica o período de tempo de ício, em segundos, para a operação.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DSTS

Este parâmetro é apenas para uso interno.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	X509FindType
Accepted values:	FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FindValue

Especifica o valor do filtro para pesquisar um certificado na loja de certificados.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Interactive

Indica se o cmdlet funciona interativamente.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MetaDataEndpoint

Este parâmetro é apenas para uso interno.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipChecks

Indica contornar as verificações de capacidade de resposta do serviço do sistema ao ligar-se ao cluster.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StoreLocation

Especifica a localização da loja de um certificado. Os valores aceitáveis para este parâmetro são:

ActualUser
LocalMachine

Type:	StoreLocation
Accepted values:	CurrentUser, LocalMachine
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StoreName

Especifica o nome da loja de certificados para carregar o certificado do cliente.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Especifica o período de tempo de ício, em segundos, para a operação.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WindowsCredential

Indica que o cmdlet utiliza credenciais do Windows para ligar a um cluster de Tecido de Serviço.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

None

Saídas

System.Object

Connect-ServiceFabricCluster

Syntax

Description

Exemplos

Exemplo 1: Ligar a um cluster

Exemplo 2: Ligar a um cluster usando um certificado X.509

Exemplo 3: Conecte-se a um cluster gerido usando um certificado X.509

Exemplo 4: Ligar-se a um cluster utilizando o Azure Ative Directory

Exemplo 5: Ligar a um cluster protegido com uma conta de serviço gerida por grupo

Exemplo 6: Ligar a um cluster protegido com contas de máquina

Exemplo 7: Ligar-se a um cluster sem as verificações primárias

Parâmetros

-AllowNetworkConnectionOnly

-AuthTokenBufferSize

-AzureActiveDirectory

-CloudServiceDNSNames

-CloudServiceName

-ClusterSpn

-ConnectionEndpoint

-ConnectionInitializationTimeoutInSec

-DSTS

-FindType

-FindValue

-GetMetadata

-HealthOperationTimeoutInSec

-HealthReportRetrySendIntervalInSec

-HealthReportSendIntervalInSec

-Interactive

-KeepAliveIntervalInSec

-MetaDataEndpoint

-PartitionLocationCacheLimit

-SecurityToken

-ServerCertThumbprint

-ServerCommonName

-ServiceChangePollIntervalInSec

-SkipChecks

-StoreLocation

-StoreName

-TimeoutSec

-WindowsCredential

-X509Credential

Entradas

Saídas

Ligações Relacionadas

Recursos adicionais