Delen via


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