Connect-ServiceFabricCluster
建立連接 Service Fabric 叢集的連線。
語法
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 會建立與獨立 Service Fabric 叢集的連線,可讓您執行該叢集的管理動作。 連線到叢集之後,您可以使用 Get-ServiceFabricClusterConnection Cmdlet 來檢視連線的設定。
若要管理 Service Fabric 叢集,請使用 [以系統管理員身分執行] 選項啟動Windows PowerShell。
範例
範例 1:連線到叢集
PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint "ServiceFabric01.ContosoCloudApp.net:19000"
此命令會建立與指定叢集的連線。
範例 2:使用 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
此命令會使用 X.509 憑證連線到叢集。 此命令會使用 Windows PowerShell 的展開功能來建立參數的雜湊表,然後將其提供給Connect-ServiceFabricCluster Cmdlet。
範例 3:使用 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
注意: 連線到受控叢集需要 PowerShell 'Az.ServiceFabric' 和 'Az.Resources' 模組,才能查詢伺服器證書指紋。
此命令會先查詢目前伺服器憑證指紋的受控叢集資源,然後使用 X509 憑證連線到叢集。 提供受控叢集的資源組名,以擷取連線資訊,包括受控叢集的完整資源識別碼。 請參閱 連線到 Service Fabric 受控叢集。
此命令接著會使用 X.509 憑證連線到叢集。
範例 4:使用 Azure Active Directory 連線到叢集
PS C:\> $ConnectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
AzureActiveDirectory = $True
ServerCertThumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs
此命令會使用 Azure Active Directory (AAD) 驗證連線到叢集。 此命令會使用 Windows PowerShell 的展開功能來建立參數的雜湊表,然後將其提供給Connect-ServiceFabricCluster Cmdlet。
範例 5:連線到使用群組管理的服務帳戶保護的叢集
PS C:\> $ConnectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
WindowsCredential = $True
ClusterSpn = 'ServiceFabric/MyCluster.MyDomain.MyOrg'
}
PS C:\> Connect-ServiceFabricCluster @connectArgs
此命令會使用 Windows PowerShell 的展開功能來建立參數的雜湊表,然後將其提供給Connect-ServiceFabricCluster Cmdlet。
範例 6:連線到使用電腦帳戶保護的叢集
PS C:\> $connectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
WindowsCredential = $True
}
PS C:\> Connect-ServiceFabricCluster @connectArgs
此命令會連線到使用電腦帳戶保護的叢集。
範例 7:在沒有主要檢查的情況下連線到叢集
PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint -SkipChecks $True "ServiceFabric01.ContosoCloudApp.net:19000"
此命令會建立與指定叢集的連線。
參數
-AllowNetworkConnectionOnly
表示 Cmdlet 允許連線到叢集,即使系統服務沒有回應,只要可以建立基礎網路連線即可。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AuthTokenBufferSize
使用 AzureActiveDirectory連線時,指定要配置給安全性權杖取得的緩衝區大小。
類型: | Int64 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AzureActiveDirectory
指定 Azure Active Directory 應該用於驗證和授權。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-CloudServiceDNSNames
此參數僅供內部使用。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CloudServiceName
此參數僅供內部使用。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ClusterSpn
指定要用於 Windows 認證的叢集安全性主體名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ConnectionEndpoint
以 ClusterAddress:ClientConnectionEndpoint 格式指定叢集的連線端點陣列,其中 ClusterAddress 是叢集資訊清單中指定的用戶端連線埠 (FQDN) 。 以方括弧括住 IPv6 位址, ([]) 。 有效的端點的格式如下:
IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint
類型: | String[] |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ConnectionInitializationTimeoutInSec
指定作業的逾時期間,以秒為單位。
類型: | Double |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DSTS
此參數僅供內部使用。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-FindType
指定在憑證存放區中搜尋憑證的 FindValue 類型。 支援下列篩選類型:
- FindByThumbprint。 依憑證指紋尋找憑證。
- FindBySubjectName。 依主體辨別名稱或一般名稱在憑證存放區中搜尋憑證時,在 FindValue中提供主體辨別名稱時,憑證中的主體名稱必須以 ASN 編碼方式編碼,因為原生 Windows 密碼編譯 API 的限制。 FindValue中提供一般名稱時沒有這類限制。
- FindBySubjectDistinguishedName
- FindByIssuerName
- FindByIssuerDistinguishedName
- FindBySerialNumber
- FindByTimeValid
- FindByTimeNotYetValid
- FindByTimeExpired
- FindByTemplateName
- FindByApplicationPolicy
- FindByCertificatePolicy
- FindByExtension
- FindByKeyUsage
- FindBySubjectKeyIdentifier
類型: | X509FindType |
接受的值: | FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-FindValue
指定篩選值,以在憑證存放區中搜尋憑證。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-GetMetadata
使用 AzureActiveDirectory連線時,匿名擷取用於取得權杖的中繼資料,而且不會嘗試任何驗證。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-HealthOperationTimeoutInSec
指定傳送健康情況報告的逾時期間,以秒為單位。 當健康情況作業逾時或失敗併發生通訊錯誤時,健康情況用戶端會在內部重試作業。
類型: | Double |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-HealthReportRetrySendIntervalInSec
指定間隔,以秒為單位,健康情況用戶端會重試傳送無法傳送或保存于健康狀態存放區的報告。 支援的最小值為 1 秒。
類型: | Double |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-HealthReportSendIntervalInSec
指定健康情況用戶端將健康情況報告傳送至健康狀態存放區的間隔,以秒為單位。 如果設定為 0,健康情況用戶端會立即傳送報告。
類型: | Double |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Interactive
指出 Cmdlet 是否以互動方式運作。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-KeepAliveIntervalInSec
指定連線保持連線期間,以秒為單位。 此間隔可防止連線因為非同步執行的作業期間處於閒置狀態而終止。
類型: | Double |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-MetaDataEndpoint
此參數僅供內部使用。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-PartitionLocationCacheLimit
指定針對服務解析快取的資料分割數目。 預設值為 0,表示沒有限制。
類型: | Int64 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SecurityToken
使用 AzureActiveDirectory連線時,會直接使用指定的安全性權杖進行驗證和授權,而不是執行互動式使用者登入。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ServerCertThumbprint
指定叢集端預期指紋的陣列。 這些指紋是用來驗證 Cmdlet 在 x509 或 Azure Active Directory 相互驗證期間連線到正確叢集的端點。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ServerCommonName
指定叢集端預期通用名稱的陣列。 這些名稱可用來驗證 Cmdlet 在 x509 或 Azure Active Directory 相互驗證期間連線到正確叢集的端點。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ServiceChangePollIntervalInSec
指定網狀架構用戶端輪詢服務變更的間隔,以秒為單位。 此間隔是由輪詢型服務位址變更通知的舊模型所使用。
類型: | Double |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SkipChecks
表示在連線到叢集時略過系統服務回應性驗證檢查。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-StoreLocation
指定憑證的存放區位置。 此參數可接受的值為:
- CurrentUser
- LocalMachine
類型: | StoreLocation |
接受的值: | CurrentUser, LocalMachine |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-StoreName
指定要載入用戶端憑證的憑證存放區名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-TimeoutSec
指定作業的逾時期間,以秒為單位。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WindowsCredential
指出 Cmdlet 會使用 Windows 認證來連線到 Service Fabric 叢集。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-X509Credential
表示 Cmdlet 會使用 x509 憑證來執行與 Service Fabric 叢集的相互驗證。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
System.Object