Aracılığıyla paylaş


Connect-ServiceFabricCluster

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

Sözdizimi

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'i 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 bir kümeye bağlanır. Bu komut, parametreler için bir karma tablosu oluşturmak üzere Windows PowerShell'in 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üme için 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'in 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'in 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ği gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AuthTokenBufferSize

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

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AzureActiveDirectory

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CloudServiceDNSNames

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

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CloudServiceName

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ClusterSpn

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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ı (FQDN) ve 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

Tür:String[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ConnectionInitializationTimeoutInSec

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

Tür:Double
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DSTS

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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'de 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. FindValueiçinde 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
Tür:X509FindType
Kabul edilen değerler:FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-FindValue

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

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-GetMetadata

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HealthOperationTimeoutInSec

Sistem durumu raporlarını göndermek için saniye cinsinden zaman aşımı süresini 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 dener.

Tür:Double
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HealthReportRetrySendIntervalInSec

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

Tür:Double
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Double
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Interactive

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

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Double
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MetaDataEndpoint

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

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SecurityToken

AzureActiveDirectoryile 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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServerCertThumbprint

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

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServerCommonName

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

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Double
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SkipChecks

Kümeye bağlanırken sistem hizmeti yanıt hızı doğrulama denetimlerini atlamayı gösterir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-StoreLocation

Sertifikanın depo konumunu belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • CurrentUser
  • LocalMachine
Tür:StoreLocation
Kabul edilen değerler:CurrentUser, LocalMachine
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-StoreName

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TimeoutSec

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

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WindowsCredential

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Çıkışlar

System.Object