Connect-ServiceFabricCluster
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