Connect-ServiceFabricCluster
Hiermee maakt u een verbinding met een Service Fabric-cluster.
Syntaxis
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
De cmdlet Connect-ServiceFabricCluster maakt een verbinding met een zelfstandig Service Fabric-cluster waarmee u beheeracties voor dat cluster kunt uitvoeren. Nadat u verbinding hebt gemaakt met een cluster, kunt u de instellingen van de verbinding weergeven met behulp van de cmdlet Get-ServiceFabricClusterConnection.
Als u Service Fabric-clusters wilt beheren, start u Windows PowerShell met behulp van de optie Als administrator uitvoeren.
Voorbeelden
Voorbeeld 1: Verbinding maken met een cluster
PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint "ServiceFabric01.ContosoCloudApp.net:19000"
Met deze opdracht maakt u een verbinding met het opgegeven cluster.
Voorbeeld 2: Verbinding maken met een cluster met behulp van een X.509-certificaat
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
Met deze opdracht maakt u verbinding met een cluster met behulp van een X.509-certificaat. Deze opdracht maakt gebruik van de splatting-functie van Windows PowerShell om een hashtabel voor parameters te maken en levert deze vervolgens aan de Connect-ServiceFabricCluster cmdlet.
Voorbeeld 3: Verbinding maken met een beheerd cluster met behulp van een X.509-certificaat
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
Opmerking: Voor het maken van verbinding met een beheerd cluster zijn PowerShell Az.ServiceFabric- en Az.Resources-modules vereist om een query uit te voeren op vingerafdruk van servercertificaten.
Met deze opdracht wordt eerst een query uitgevoerd op beheerde clusterresources voor de vingerafdruk van het huidige servercertificaat en maakt vervolgens verbinding met het cluster met behulp van het X509-certificaat. Geef de naam op van de resourcegroep voor het beheerde cluster om verbindingsgegevens op te halen, inclusief de volledige resource-id voor het beheerde cluster. Zie Verbinding maken met een beheerd Service Fabric-cluster.
Met deze opdracht maakt u vervolgens verbinding met een cluster met behulp van een X.509-certificaat.
Voorbeeld 4: Verbinding maken met een cluster met behulp van Azure Active Directory
PS C:\> $ConnectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
AzureActiveDirectory = $True
ServerCertThumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs
Met deze opdracht maakt u verbinding met een cluster met behulp van AAD-verificatie (Azure Active Directory). Deze opdracht maakt gebruik van de splatting-functie van Windows PowerShell om een hashtabel voor parameters te maken en levert deze vervolgens aan de Connect-ServiceFabricCluster cmdlet.
Voorbeeld 5: Verbinding maken met een cluster dat is beveiligd met een door groepen beheerd serviceaccount
PS C:\> $ConnectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
WindowsCredential = $True
ClusterSpn = 'ServiceFabric/MyCluster.MyDomain.MyOrg'
}
PS C:\> Connect-ServiceFabricCluster @connectArgs
Deze opdracht maakt gebruik van de splatting-functie van Windows PowerShell om een hashtabel voor parameters te maken en levert deze vervolgens aan de Connect-ServiceFabricCluster cmdlet.
Voorbeeld 6: Verbinding maken met een cluster dat is beveiligd met computeraccounts
PS C:\> $connectArgs = @{
ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
WindowsCredential = $True
}
PS C:\> Connect-ServiceFabricCluster @connectArgs
Met deze opdracht wordt verbinding gemaakt met een cluster dat is beveiligd met computeraccounts.
Voorbeeld 7: Verbinding maken met een cluster zonder de primaire controles
PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint -SkipChecks $True "ServiceFabric01.ContosoCloudApp.net:19000"
Met deze opdracht maakt u een verbinding met het opgegeven cluster.
Parameters
-AllowNetworkConnectionOnly
Geeft aan dat de cmdlet verbinding met het cluster toestaat, zelfs wanneer systeemservices niet reageren zolang er een onderliggende netwerkverbinding tot stand kan worden gebracht.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-AuthTokenBufferSize
Wanneer u verbinding maakt met AzureActiveDirectory, geeft u de buffergrootte op die moet worden toegewezen voor het verkrijgen van beveiligingstokens.
Type: | Int64 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-AzureActiveDirectory
Hiermee geeft u op dat Azure Active Directory moet worden gebruikt voor verificatie en autorisatie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-CloudServiceDNSNames
Deze parameter is alleen voor intern gebruik.
Type: | String[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-CloudServiceName
Deze parameter is alleen voor intern gebruik.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ClusterSpn
Hiermee geeft u de principal-naam voor clusterbeveiliging op die moet worden gebruikt voor Windows-referenties.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ConnectionEndpoint
Hiermee geeft u een matrix van verbindingseindpunten voor het cluster in de indeling ClusterAddress: ClientConnectionEndpoint, waarbij ClusterAddress het IPv4-adres, IPv6-adres of FQDN (Fully Qualified Domain Name) van het clusterknooppunt is om verbinding te maken met en ClientConnectionEndpoint is de clientverbindingspoort die is opgegeven in het clustermanifest. Plaats IPv6-adressen tussen vierkante haken ([]). Geldige eindpunten hebben het volgende formulier:
IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint
Type: | String[] |
Position: | 0 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ConnectionInitializationTimeoutInSec
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking.
Type: | Double |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DSTS
Deze parameter is alleen voor intern gebruik.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-FindType
Hiermee geeft u het type FindValue voor het zoeken naar certificaten in het certificaatarchief. De volgende filtertypen worden ondersteund:
- FindByThumbprint. Zoek het certificaat op vingerafdruk van het certificaat.
- FindBySubjectName. Zoekcertificaat in het certificaatarchief op onderwerp dn-naam of algemene naam, wanneer onderwerp dn-naam is opgegeven in FindValue, moet de onderwerpnaam in het certificaat worden gecodeerd in ASN-codering vanwege een beperking in systeemeigen Windows-crypto-API. Er is geen dergelijke beperking wanneer algemene naam wordt opgegeven in FindValue.
- FindBySubjectDistinguishedName
- FindByIssuerName
- FindByIssuerDistinguishedName
- FindBySerialNumber
- FindByTimeValid
- FindByTimeNotYetValid
- FindByTimeExpired
- FindByTemplateName
- FindByApplicationPolicy
- FindByCertificatePolicy
- FindByExtension
- FindByKeyUsage
- FindBySubjectKeyIdentifier
Type: | X509FindType |
Geaccepteerde waarden: | FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-FindValue
Hiermee geeft u filterwaarde om een certificaat in het certificaatarchief te doorzoeken.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-GetMetadata
Wanneer u verbinding maakt met AzureActiveDirectory, worden de metagegevens die worden gebruikt voor het verkrijgen van tokens anoniem opgehaald en wordt er geen verificatie uitgevoerd.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-HealthOperationTimeoutInSec
Hiermee geeft u de time-outperiode in seconden op voor het verzenden van statusrapporten. Wanneer er een time-out optreedt voor een statusbewerking of mislukt met een communicatiefout, probeert de statusclient de bewerking intern opnieuw uit te voeren.
Type: | Double |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-HealthReportRetrySendIntervalInSec
Hiermee geeft u het interval op, in seconden, waarbij de statusclient opnieuw probeert de rapporten te verzenden die niet konden worden verzonden of om te worden bewaard in het statusarchief. De minimaal ondersteunde waarde is 1 seconde.
Type: | Double |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-HealthReportSendIntervalInSec
Hiermee geeft u het interval, in seconden, waarmee de statusclient de statusrapporten naar het statusarchief verzendt. Als deze optie is ingesteld op 0, verzendt de statusclient de rapporten onmiddellijk.
Type: | Double |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Interactive
Geeft aan of de cmdlet interactief werkt.
Type: | Boolean |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-KeepAliveIntervalInSec
Hiermee geeft u de keep-alive-periode in seconden. Dit interval voorkomt dat een verbinding wordt beëindigd vanwege inactiviteit tijdens bewerkingen die asynchroon worden uitgevoerd.
Type: | Double |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-MetaDataEndpoint
Deze parameter is alleen voor intern gebruik.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PartitionLocationCacheLimit
Hiermee geeft u het aantal partities opgeslagen in de cache voor serviceomzetting. De standaardwaarde is 0, waarmee geen limiet wordt opgegeven.
Type: | Int64 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-SecurityToken
Wanneer u verbinding maakt met AzureActiveDirectory-, wordt het opgegeven beveiligingstoken rechtstreeks gebruikt voor verificatie en autorisatie in plaats van interactieve gebruikersaanmelding uit te voeren.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ServerCertThumbprint
Hiermee geeft u een matrix van de verwachte vingerafdrukken voor de clusterzijde. Deze vingerafdrukken worden gebruikt om te verifiëren dat de cmdlet verbinding maakt met het eindpunt van het juiste cluster tijdens wederzijdse verificatie van x509 of Azure Active Directory.
Type: | String[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ServerCommonName
Hiermee geeft u een matrix van de verwachte algemene namen voor de clusterzijde. Deze namen worden gebruikt om te verifiëren dat de cmdlet verbinding maakt met het eindpunt van het juiste cluster tijdens x509 of wederzijdse verificatie van Azure Active Directory.
Type: | String[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ServiceChangePollIntervalInSec
Hiermee geeft u het interval op, in seconden, waarop de fabric-client controleert op servicewijzigingen. Dit interval wordt gebruikt door het oude model van op poll gebaseerde serviceadreswijzigingsmeldingen.
Type: | Double |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-SkipChecks
Geeft aan dat de reactietijdvalidatie van de systeemservice wordt overgeslagen bij het maken van verbinding met het cluster.
Type: | Boolean |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-StoreLocation
Hiermee geeft u de opslaglocatie van een certificaat. De acceptabele waarden voor deze parameter zijn:
- CurrentUser
- LocalMachine
Type: | StoreLocation |
Geaccepteerde waarden: | CurrentUser, LocalMachine |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-StoreName
Hiermee geeft u de naam van het certificaatarchief om het clientcertificaat te laden.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking.
Type: | Int32 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-WindowsCredential
Geeft aan dat de cmdlet Windows-referenties gebruikt om verbinding te maken met een Service Fabric-cluster.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-X509Credential
Geeft aan dat de cmdlet een x509-certificaat gebruikt om wederzijdse verificatie uit te voeren met een Service Fabric-cluster.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
None
Uitvoerwaarden
System.Object