Connect-ServiceFabricCluster

Referentie

Module:: ServiceFabric

Hiermee wordt een verbinding gemaakt 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 Uitvoeren als administrator.

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 hash-tabel te maken voor parameters en levert deze vervolgens aan de cmdlet Connect-ServiceFabricCluster.

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 query's uit te voeren op vingerafdruk van servercertificaten.

Met deze opdracht wordt eerst een query uitgevoerd op beheerde clusterresources voor de huidige vingerafdruk van het 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 hash-tabel te maken voor parameters en levert deze vervolgens aan de cmdlet Connect-ServiceFabricCluster.

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 hash-tabel te maken voor parameters en levert deze vervolgens aan de cmdlet Connect-ServiceFabricCluster.

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 maakt u verbinding 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 toestaat verbinding te maken met het cluster, 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 van de 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, op 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 certificaat in certificaatarchief. De volgende filtertypen worden ondersteund:

FindByThumbprint. Certificaat zoeken op vingerafdruk van certificaat.
FindBySubjectName. Zoekcertificaat in certificaatarchief op DN-onderwerpnaam of algemene naam, wanneer de DN-naam van het onderwerp wordt opgegeven in FindValue, moet de onderwerpnaam in het certificaat worden gecodeerd in ASN-codering vanwege een beperking in de systeemeigen Windows-crypto-API. Er is geen dergelijke beperking wanneer de 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 voor het doorzoeken van een certificaat in het certificaatarchief.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-GetMetadata

Wanneer u verbinding maakt met AzureActiveDirectory, haalt u anoniem de metagegevens op die worden gebruikt voor het ophalen van tokens 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.

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 dit 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 op dat is 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 wederzijdse verificatie van x509 of 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

Hiermee wordt aangegeven dat de reactietijdvalidatie van de systeemservice moet worden 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 aanvaardbare 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, op 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

Delen via

Connect-ServiceFabricCluster

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Verbinding maken met een cluster

Voorbeeld 2: Verbinding maken met een cluster met behulp van een X.509-certificaat

Voorbeeld 3: Verbinding maken met een beheerd cluster met behulp van een X.509-certificaat

Voorbeeld 4: Verbinding maken met een cluster met behulp van Azure Active Directory

Voorbeeld 5: Verbinding maken met een cluster dat is beveiligd met een door groepen beheerd serviceaccount

Voorbeeld 6: Verbinding maken met een cluster dat is beveiligd met computeraccounts

Voorbeeld 7: Verbinding maken met een cluster zonder de primaire controles

Parameters

-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

Invoerwaarden

Uitvoerwaarden

Verwante koppelingen

Aanvullende resources