Connect-ServiceFabricCluster
Hiermee wordt een verbinding gemaakt met een Service Fabric-cluster.
Syntax
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AzureActiveDirectory
Hiermee geeft u op dat Azure Active Directory moet worden gebruikt voor verificatie en autorisatie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CloudServiceDNSNames
Deze parameter is alleen voor intern gebruik.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CloudServiceName
Deze parameter is alleen voor intern gebruik.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionInitializationTimeoutInSec
Hiermee geeft u de time-outperiode, in seconden, op voor de bewerking.
Type: | Double |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DSTS
Deze parameter is alleen voor intern gebruik.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accepted values: | FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FindValue
Hiermee geeft u filterwaarde voor het doorzoeken van een certificaat in het certificaatarchief.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Interactive
Geeft aan of de cmdlet interactief werkt.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MetaDataEndpoint
Deze parameter is alleen voor intern gebruik.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StoreLocation
Hiermee geeft u de opslaglocatie van een certificaat. De aanvaardbare waarden voor deze parameter zijn:
- CurrentUser
- LocalMachine
Type: | StoreLocation |
Accepted values: | CurrentUser, LocalMachine |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StoreName
Hiermee geeft u de naam van het certificaatarchief om het clientcertificaat te laden.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, op voor de bewerking.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
None
Uitvoerwaarden
System.Object