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.
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
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
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
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
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.
Parametereigenschappen
Type:
SwitchParameter
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-AuthTokenBufferSize
Wanneer u verbinding maakt met AzureActiveDirectory, geeft u de buffergrootte op die moet worden toegewezen voor het verkrijgen van beveiligingstokens.
Parametereigenschappen
Type:
Int64
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-AzureActiveDirectory
Hiermee geeft u op dat Azure Active Directory moet worden gebruikt voor verificatie en autorisatie.
Parametereigenschappen
Type:
SwitchParameter
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Aad
Position:
Named
Verplicht:
True
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-CloudServiceDNSNames
Deze parameter is alleen voor intern gebruik.
Parametereigenschappen
Type:
String[]
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Dsts
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-CloudServiceName
Deze parameter is alleen voor intern gebruik.
Parametereigenschappen
Type:
String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Dsts
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-ClusterSpn
Hiermee geeft u de principal-naam voor clusterbeveiliging op die moet worden gebruikt voor Windows-referenties.
Parametereigenschappen
Type:
String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Windows
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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:
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking.
Parametereigenschappen
Type:
Double
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-DSTS
Deze parameter is alleen voor intern gebruik.
Parametereigenschappen
Type:
SwitchParameter
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Dsts
Position:
Named
Verplicht:
True
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Hiermee geeft u filterwaarde om een certificaat in het certificaatarchief te doorzoeken.
Parametereigenschappen
Type:
String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
X509
Position:
Named
Verplicht:
True
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
SwitchParameter
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Aad
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
Double
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
Double
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
Double
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-Interactive
Geeft aan of de cmdlet interactief werkt.
Parametereigenschappen
Type:
Boolean
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Dsts
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
Double
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-MetaDataEndpoint
Deze parameter is alleen voor intern gebruik.
Parametereigenschappen
Type:
String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Dsts
Position:
Named
Verplicht:
True
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-PartitionLocationCacheLimit
Hiermee geeft u het aantal partities opgeslagen in de cache voor serviceomzetting.
De standaardwaarde is 0, waarmee geen limiet wordt opgegeven.
Parametereigenschappen
Type:
Int64
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Aad
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
String[]
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
X509
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
Dsts
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
Aad
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
String[]
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
X509
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
Dsts
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
Aad
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
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.
Parametereigenschappen
Type:
Double
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-SkipChecks
Geeft aan dat de reactietijdvalidatie van de systeemservice wordt overgeslagen bij het maken van verbinding met het cluster.
Parametereigenschappen
Type:
Boolean
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-StoreLocation
Hiermee geeft u de opslaglocatie van een certificaat.
De acceptabele waarden voor deze parameter zijn:
CurrentUser
LocalMachine
Parametereigenschappen
Type:
StoreLocation
Default value:
None
Geaccepteerde waarden:
CurrentUser, LocalMachine
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
X509
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-StoreName
Hiermee geeft u de naam van het certificaatarchief om het clientcertificaat te laden.
Parametereigenschappen
Type:
String
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
X509
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking.
Parametereigenschappen
Type:
Int32
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
(All)
Position:
Named
Verplicht:
False
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-WindowsCredential
Geeft aan dat de cmdlet Windows-referenties gebruikt om verbinding te maken met een Service Fabric-cluster.
Parametereigenschappen
Type:
SwitchParameter
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
Windows
Position:
Named
Verplicht:
True
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
-X509Credential
Geeft aan dat de cmdlet een x509-certificaat gebruikt om wederzijdse verificatie uit te voeren met een Service Fabric-cluster.
Parametereigenschappen
Type:
SwitchParameter
Default value:
None
Ondersteunt jokertekens:
False
DontShow:
False
Parametersets
X509
Position:
Named
Verplicht:
True
Waarde uit pijplijn:
False
Waarde uit pijplijn op eigenschapsnaam:
False
Waarde van resterende argumenten:
False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.