Connect-ServiceFabricCluster

Referensi

Modul:: ServiceFabric

Membuat koneksi ke kluster Service Fabric.

Sintaks

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>]

Deskripsi

Cmdlet Connect-ServiceFabricCluster membuat koneksi ke kluster Service Fabric mandiri yang memungkinkan Anda menjalankan tindakan manajemen untuk kluster tersebut. Setelah tersambung ke kluster, Anda dapat melihat pengaturan koneksi dengan menggunakan cmdlet Get-ServiceFabricClusterConnection .

Untuk mengelola kluster Service Fabric, mulai Windows PowerShell dengan menggunakan opsi Jalankan sebagai administrator.

Contoh

Contoh 1: Menyambungkan ke kluster

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

Perintah ini membuat koneksi ke kluster yang ditentukan.

Contoh 2: Menyambungkan ke kluster menggunakan sertifikat 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

Perintah ini tersambung ke kluster menggunakan sertifikat X.509. Perintah ini menggunakan fitur percikan Windows PowerShell untuk membuat tabel hash untuk parameter, lalu memasoknya ke cmdlet Connect-ServiceFabricCluster.

Contoh 3: Menyambungkan ke kluster terkelola menggunakan sertifikat 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

Catatan: Menyambungkan ke kluster terkelola memerlukan modul PowerShell 'Az.ServiceFabric' dan 'Az.Resources' untuk meminta thumbprint sertifikat server.

Perintah ini pertama kali mengkueri sumber daya kluster terkelola untuk thumbprint sertifikat server saat ini, lalu menyambungkan ke kluster menggunakan sertifikat X509. Berikan nama grup sumber daya untuk kluster terkelola untuk mengambil informasi koneksi termasuk id sumber daya lengkap untuk kluster terkelola. Lihat Menyambungkan ke kluster yang dikelola Service Fabric.

Perintah ini kemudian terhubung ke kluster menggunakan sertifikat X.509.

Contoh 4: Menyambungkan ke kluster menggunakan Azure Active Directory

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

Perintah ini tersambung ke kluster menggunakan autentikasi Azure Active Directory (AAD). Perintah ini menggunakan fitur percikan Windows PowerShell untuk membuat tabel hash untuk parameter, lalu memasoknya ke cmdlet Connect-ServiceFabricCluster.

Contoh 5: Menyambungkan ke kluster yang diamankan dengan akun layanan yang dikelola grup

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

Perintah ini menggunakan fitur percikan Windows PowerShell untuk membuat tabel hash untuk parameter, lalu memasoknya ke cmdlet Connect-ServiceFabricCluster.

Contoh 6: Menyambungkan ke kluster yang diamankan dengan akun komputer

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

Perintah ini terhubung ke kluster yang diamankan dengan akun komputer.

Contoh 7: Menyambungkan ke kluster tanpa pemeriksaan utama

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

Perintah ini membuat koneksi ke kluster yang ditentukan.

Parameter

-AllowNetworkConnectionOnly

Menunjukkan bahwa cmdlet memungkinkan koneksi ke kluster bahkan ketika layanan sistem tidak responsif selama koneksi jaringan yang mendasar dapat dibuat.

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

-AuthTokenBufferSize

Saat menyambungkan dengan AzureActiveDirectory, menentukan ukuran buffer untuk dialokasikan untuk akuisisi token keamanan.

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

-AzureActiveDirectory

Menentukan bahwa Azure Active Directory harus digunakan untuk autentikasi dan otorisasi.

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

-CloudServiceDNSNames

Parameter ini hanya untuk penggunaan internal.

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

-CloudServiceName

Parameter ini hanya untuk penggunaan internal.

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

-ClusterSpn

Menentukan nama prinsip keamanan kluster yang akan digunakan untuk kredensial Windows.

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

-ConnectionEndpoint

Menentukan array titik akhir koneksi untuk kluster dalam format ClusterAddress: ClientConnectionEndpoint, di mana ClusterAddress adalah alamat IPv4, alamat IPv6, atau nama domain yang sepenuhnya memenuhi syarat (FQDN) dari node kluster untuk disambungkan dan ClientConnectionEndpoint adalah port koneksi klien yang ditentukan dalam manifes kluster. Sertakan alamat IPv6 dalam tanda kurung siku ([]). Titik akhir yang valid memiliki formulir berikut:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

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

-ConnectionInitializationTimeoutInSec

Menentukan periode waktu habis, dalam detik, untuk operasi.

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

-DSTS

Parameter ini hanya untuk penggunaan internal.

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

-FindType

Menentukan tipe FindValue untuk mencari sertifikat di penyimpanan sertifikat. Jenis filter berikut ini didukung:

FindByThumbprint. Temukan sertifikat berdasarkan thumbprint sertifikat.
FindBySubjectName. Sertifikat pencarian di penyimpanan sertifikat berdasarkan nama khusus subjek atau nama umum, ketika nama khusus subjek disediakan di FindValue, nama subjek dalam sertifikat harus dikodekan dalam pengodean ASN karena pembatasan dalam API kripto Windows asli. Tidak ada batasan seperti itu ketika nama umum disediakan di FindValue.
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

Menentukan nilai filter untuk mencari sertifikat di penyimpanan sertifikat.

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

-GetMetadata

Saat menyambungkan dengan AzureActiveDirectory, secara anonim mengambil metadata yang digunakan untuk akuisisi token dan tidak mencoba autentikasi apa pun.

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

-HealthOperationTimeoutInSec

Menentukan periode waktu habis, dalam detik, untuk mengirim laporan kesehatan. Ketika operasi kesehatan kehabisan waktu atau gagal dengan kesalahan komunikasi, klien kesehatan secara internal mencoba kembali operasi.

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

-HealthReportRetrySendIntervalInSec

Menentukan interval, dalam hitungan detik, di mana klien kesehatan mencoba kembali mengirim laporan yang gagal dikirim atau disimpan di penyimpanan kesehatan. Nilai minimum yang didukung adalah 1 detik.

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

-HealthReportSendIntervalInSec

Menentukan interval, dalam hitungan detik, di mana klien kesehatan mengirim laporan kesehatan ke penyimpanan kesehatan. Jika diatur ke 0, klien kesehatan akan segera mengirim laporan.

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

-Interactive

Menunjukkan apakah cmdlet beroperasi secara interaktif.

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

-KeepAliveIntervalInSec

Menentukan periode koneksi tetap hidup dalam hitungan detik. Interval ini mencegah koneksi dihentikan karena tidak aktif selama operasi yang berjalan secara asinkron.

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

-MetaDataEndpoint

Parameter ini hanya untuk penggunaan internal.

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

-PartitionLocationCacheLimit

Menentukan jumlah partisi yang di-cache untuk resolusi layanan. Nilai defaultnya adalah 0, yang menandakan tidak ada batasan.

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

-SecurityToken

Saat menyambungkan dengan AzureActiveDirectory, token keamanan yang ditentukan digunakan langsung untuk autentikasi dan otorisasi daripada melakukan login pengguna interaktif.

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

-ServerCertThumbprint

Menentukan array thumbprint yang diharapkan untuk sisi kluster. Thumbprint ini digunakan untuk mengautentikasi bahwa cmdlet terhubung ke titik akhir kluster yang benar selama autentikasi bersama x509 atau Azure Active Directory.

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

-ServerCommonName

Menentukan array dari nama umum yang diharapkan untuk sisi kluster. Nama-nama ini digunakan untuk mengautentikasi bahwa cmdlet terhubung ke titik akhir kluster yang benar selama x509 atau autentikasi bersama Azure Active Directory.

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

-ServiceChangePollIntervalInSec

Menentukan interval, dalam detik, di mana klien fabric melakukan polling untuk perubahan layanan. Interval ini digunakan oleh model lama pemberitahuan perubahan alamat layanan berbasis polling.

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

-SkipChecks

Menunjukkan untuk melewati pemeriksaan validasi responsivitas layanan sistem saat menyambungkan ke kluster.

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

-StoreLocation

Menentukan lokasi penyimpanan sertifikat. Nilai yang dapat diterima untuk parameter ini adalah:

CurrentUser
LocalMachine

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

-StoreName

Menentukan nama penyimpanan sertifikat untuk memuat sertifikat klien.

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

-TimeoutSec

Menentukan periode waktu habis, dalam detik, untuk operasi.

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

-WindowsCredential

Menunjukkan bahwa cmdlet menggunakan kredensial Windows untuk terhubung ke kluster Service Fabric.

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

-X509Credential

Menunjukkan bahwa cmdlet menggunakan sertifikat x509 untuk melakukan autentikasi bersama dengan kluster Service Fabric.

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

Input

None

Output

System.Object

Connect-ServiceFabricCluster

Sintaks

Deskripsi

Contoh

Contoh 1: Menyambungkan ke kluster

Contoh 2: Menyambungkan ke kluster menggunakan sertifikat X.509

Contoh 3: Menyambungkan ke kluster terkelola menggunakan sertifikat X.509

Contoh 4: Menyambungkan ke kluster menggunakan Azure Active Directory

Contoh 5: Menyambungkan ke kluster yang diamankan dengan akun layanan yang dikelola grup

Contoh 6: Menyambungkan ke kluster yang diamankan dengan akun komputer

Contoh 7: Menyambungkan ke kluster tanpa pemeriksaan utama

Parameter

-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

Input

Output

Link Terkait

Sumber Daya Tambahan: