Connect-ServiceFabricCluster

Başvuru

Modül:: ServiceFabric

Service Fabric kümesine bağlantı oluşturur.

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

Connect-ServiceFabricCluster cmdlet'i, tek başına bir Service Fabric kümesine bağlantı oluşturur ve bu küme için yönetim eylemlerini çalıştırmanızı sağlar. Bir kümeye bağlandıktan sonra Get-ServiceFabricClusterConnection cmdlet'ini kullanarak bağlantının ayarlarını görüntüleyebilirsiniz.

Service Fabric kümelerini yönetmek için Yönetici olarak çalıştır seçeneğini kullanarak Windows PowerShell başlatın.

Örnekler

Örnek 1: Kümeye bağlanma

PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint "ServiceFabric01.ContosoCloudApp.net:19000"

Bu komut, belirtilen kümeye bir bağlantı oluşturur.

Örnek 2: X.509 sertifikası kullanarak kümeye bağlanma

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

Bu komut bir X.509 sertifikası kullanarak kümeye bağlanır. Bu komut, parametreler için bir karma tablosu oluşturmak üzere Windows PowerShell'nin sıçrama özelliğini kullanır ve bunları Connect-ServiceFabricCluster cmdlet'ine sağlar.

Örnek 3: X.509 sertifikası kullanarak yönetilen kümeye bağlanma

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

Not: Yönetilen kümeye bağlanmak için sunucu sertifikası parmak izlerini sorgulamak için PowerShell 'Az.ServiceFabric' ve 'Az.Resources' modülleri gerekir.

Bu komut önce geçerli sunucu sertifikası parmak izleri için yönetilen küme kaynağını sorgular, ardından X509 sertifikasını kullanarak kümeye bağlanır. Yönetilen kümenin tam kaynak kimliği de dahil olmak üzere bağlantı bilgilerini almak için yönetilen kümenin kaynak grubunun adını sağlayın. Bkz . Service Fabric yönetilen kümesine bağlanma.

Bu komut daha sonra bir X.509 sertifikası kullanarak bir kümeye bağlanır.

Örnek 4: Azure Active Directory kullanarak kümeye bağlanma

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    AzureActiveDirectory = $True
    ServerCertThumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs

Bu komut, Azure Active Directory (AAD) kimlik doğrulamasını kullanarak bir kümeye bağlanır. Bu komut, parametreler için bir karma tablosu oluşturmak üzere Windows PowerShell'nin sıçrama özelliğini kullanır ve bunları Connect-ServiceFabricCluster cmdlet'ine sağlar.

Örnek 5: Grup tarafından yönetilen hizmet hesabıyla güvenliği sağlanan bir kümeye bağlanma

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    WindowsCredential = $True
    ClusterSpn = 'ServiceFabric/MyCluster.MyDomain.MyOrg'
}
PS C:\> Connect-ServiceFabricCluster @connectArgs

Bu komut, parametreler için bir karma tablosu oluşturmak üzere Windows PowerShell'nin sıçrama özelliğini kullanır ve bunları Connect-ServiceFabricCluster cmdlet'ine sağlar.

Örnek 6: Makine hesaplarıyla güvenliği sağlanan bir kümeye bağlanma

PS C:\> $connectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    WindowsCredential = $True
}
PS C:\> Connect-ServiceFabricCluster @connectArgs

Bu komut, makine hesaplarıyla güvenliği sağlanan bir kümeye bağlanır.

Örnek 7: Birincil denetimler olmadan kümeye bağlanma

PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint -SkipChecks $True "ServiceFabric01.ContosoCloudApp.net:19000"

Bu komut, belirtilen kümeye bir bağlantı oluşturur.

Parametreler

-AllowNetworkConnectionOnly

Temel alınan bir ağ bağlantısı kurulabildiği sürece sistem hizmetleri yanıt vermediğinde bile cmdlet'in kümeye bağlanmaya izin verdiğine işaret eder.

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

-AuthTokenBufferSize

AzureActiveDirectory ile bağlanırken, güvenlik belirteci alımı için ayrılacak arabellek boyutunu belirtir.

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

-AzureActiveDirectory

Kimlik doğrulaması ve yetkilendirme için Azure Active Directory'nin kullanılması gerektiğini belirtir.

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

-CloudServiceDNSNames

Bu parametre yalnızca iç kullanım içindir.

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

-CloudServiceName

Bu parametre yalnızca iç kullanım içindir.

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

-ClusterSpn

Windows kimlik bilgileri için kullanılacak küme güvenlik sorumlusu adını belirtir.

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

-ConnectionEndpoint

Küme için bağlantı uç noktaları dizisini ClusterAddress biçiminde belirtir: ClientConnectionEndpoint; burada ClusterAddress, bağlanacak küme düğümünün IPv4 adresi, IPv6 adresi veya tam etki alanı adıdır (FQDN), ClientConnectionEndpoint ise küme bildiriminde belirtilen istemci bağlantı noktasıdır. IPv6 adreslerini köşeli ayraç ([]) içine alın. Geçerli uç noktaların biçimi şu şekildedir:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

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

-ConnectionInitializationTimeoutInSec

İşlem için zaman aşımı süresini saniye cinsinden belirtir.

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

-DSTS

Bu parametre yalnızca iç kullanım içindir.

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

-FindType

Sertifika deposunda sertifika aramak için FindValue türünü belirtir. Aşağıdaki filtre türleri desteklenir:

FindByThumbprint. Sertifika parmak izine göre sertifika bulun.
FindBySubjectName. Sertifika deposundaki sertifikayı konu ayırt edici adına veya ortak ada göre arayın; FindValue'da konu ayırt edici adı sağlandığında, yerel Windows şifreleme API'sindeki bir kısıtlama nedeniyle sertifikadaki konu adı ASN kodlamasında kodlanmalıdır. FindValue'da ortak ad sağlandığında böyle bir kısıtlama yoktur.
FindBySubjectDistinguishedName
FindByIssuerName
FindByIssuerDistinguishedName
FindBySerialNumber
FindByTimeValid
FindByTimeNotYetValid
FindByTimeExpired
FindByTemplateName
FindByApplicationPolicy
FindByCertificatePolicy
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

Sertifika deposunda bir sertifikada arama yapmak için filtre değerini belirtir.

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

-GetMetadata

AzureActiveDirectory ile bağlanırken, belirteç alımı için kullanılan meta verileri anonim olarak alır ve herhangi bir kimlik doğrulaması denemez.

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

-HealthOperationTimeoutInSec

Sistem durumu raporlarını göndermek için zaman aşımı süresini saniye cinsinden belirtir. Sistem durumu işlemi zaman aşımına uğradıysa veya bir iletişim hatasıyla başarısız olduğunda, sistem durumu istemcisi işlemi dahili olarak yeniden denenir.

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

-HealthReportRetrySendIntervalInSec

Sistem durumu istemcisinin gönderilemeyen veya sistem durumu deposunda kalıcı hale getirmek için raporları göndermeyi yeniden denemesi aralığını saniye cinsinden belirtir. Desteklenen en düşük değer 1 saniyedir.

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

-HealthReportSendIntervalInSec

Sistem durumu istemcisinin sistem durumu raporlarını sistem durumu deposuna gönderdiği aralığı saniye cinsinden belirtir. 0 olarak ayarlanırsa, sistem durumu istemcisi raporları hemen gönderir.

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

-Interactive

Cmdlet'in etkileşimli çalışıp çalışmadığını gösterir.

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

-KeepAliveIntervalInSec

Bağlantı etkin tutma süresini saniye cinsinden belirtir. Bu aralık, zaman uyumsuz olarak çalıştırılan işlemler sırasında işlem yapılmadığı için bağlantının sonlandırılmasını engeller.

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

-MetaDataEndpoint

Bu parametre yalnızca iç kullanım içindir.

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

-PartitionLocationCacheLimit

Hizmet çözümlemesi için önbelleğe alınan bölüm sayısını belirtir. Varsayılan değer 0'dır ve bu da sınır olmadığını gösterir.

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

-SecurityToken

AzureActiveDirectory ile bağlanırken, belirtilen güvenlik belirteci etkileşimli kullanıcı oturum açma işlemleri yerine doğrudan kimlik doğrulaması ve yetkilendirme için kullanılır.

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

-ServerCertThumbprint

Küme tarafı için beklenen parmak izlerinin dizisini belirtir. Bu parmak izleri, x509 veya Azure Active Directory karşılıklı kimlik doğrulaması sırasında cmdlet'in doğru kümenin uç noktasına bağlandığını doğrulamak için kullanılır.

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

-ServerCommonName

Küme tarafı için beklenen ortak adlardan oluşan bir dizi belirtir. Bu adlar, x509 veya Azure Active Directory karşılıklı kimlik doğrulaması sırasında cmdlet'in doğru kümenin uç noktasına bağlandığını doğrulamak için kullanılır.

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

-ServiceChangePollIntervalInSec

Doku istemcisinin hizmet değişikliklerini yokladığı aralığı saniye cinsinden belirtir. Bu aralık, yoklama tabanlı hizmet adresi değişiklik bildirimlerinin eski modeli tarafından kullanılır.

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

-SkipChecks

Kümeye bağlanırken sistem hizmetinin yanıt verme süresi doğrulama denetimlerini atlamayı gösterir.

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

-StoreLocation

Bir sertifikanın depolama konumunu belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

CurrentUser
LocalMachine

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

-StoreName

İstemci sertifikasını yüklemek için sertifika deposunun adını belirtir.

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

-TimeoutSec

İşlem için zaman aşımı süresini saniye cinsinden belirtir.

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

-WindowsCredential

Cmdlet'in bir Service Fabric kümesine bağlanmak için Windows kimlik bilgilerini kullandığını gösterir.

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

-X509Credential

Cmdlet'in Service Fabric kümesiyle karşılıklı kimlik doğrulaması gerçekleştirmek için bir x509 sertifikası kullandığını gösterir.

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

Girişler

None

Çıkışlar

System.Object

Connect-ServiceFabricCluster

Syntax

Description

Örnekler

Örnek 1: Kümeye bağlanma

Örnek 2: X.509 sertifikası kullanarak kümeye bağlanma

Örnek 3: X.509 sertifikası kullanarak yönetilen kümeye bağlanma

Örnek 4: Azure Active Directory kullanarak kümeye bağlanma

Örnek 5: Grup tarafından yönetilen hizmet hesabıyla güvenliği sağlanan bir kümeye bağlanma

Örnek 6: Makine hesaplarıyla güvenliği sağlanan bir kümeye bağlanma

Örnek 7: Birincil denetimler olmadan kümeye bağlanma

Parametreler

-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

Girişler

Çıkışlar

İlişkili Bağlantılar

Ek kaynaklar