Connect-ServiceFabricCluster

參考

模組:: ServiceFabric

建立 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是叢集節點的 IPv4 位址、IPv6 位址或完整功能變數名稱（FQDN），而 ClientConnectionEndpoint 是叢集指令清單中指定的用戶端聯機埠。以方括弧（[]）括住 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

共用方式為

Connect-ServiceFabricCluster

語法

Description

範例

範例 1：連線到叢集

範例 2：使用 X.509 憑證連線到叢集

範例 3：使用 X.509 憑證連線到受控叢集

範例 4：使用 Azure Active Directory 連線到叢集

範例 5：連線到使用群組管理的服務帳戶保護的叢集

範例 6：連線到使用電腦帳戶保護的叢集

範例 7：在沒有主要檢查的情況下連線到叢集

參數

-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

輸入

輸出

相關連結

其他資源