Connect-ServiceFabricCluster

Referens

Modul:: ServiceFabric

Skapar en anslutning till ett Service Fabric-kluster.

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

Cmdleten Connect-ServiceFabricCluster skapar en anslutning till ett fristående Service Fabric-kluster som gör att du kan köra hanteringsåtgärder för klustret. När du har anslutit till ett kluster kan du visa inställningarna för anslutningen med hjälp av cmdleten Get-ServiceFabricClusterConnection .

Om du vill hantera Service Fabric-kluster startar du Windows PowerShell med alternativet Kör som administratör.

Exempel

Exempel 1: Ansluta till ett kluster

PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint "ServiceFabric01.ContosoCloudApp.net:19000"

Det här kommandot skapar en anslutning till det angivna klustret.

Exempel 2: Ansluta till ett kluster med ett X.509-certifikat

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

Det här kommandot ansluter till ett kluster med ett X.509-certifikat. Det här kommandot använder funktionen splatting i Windows PowerShell för att skapa en hash-tabell för parametrar och tillhandahåller dem sedan till cmdleten Connect-ServiceFabricCluster.

Exempel 3: Ansluta till ett hanterat kluster med ett X.509-certifikat

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

Observera: För att ansluta till ett hanterat kluster krävs PowerShell-modulerna Az.ServiceFabric och Az.Resources för att fråga efter tumavtryck för servercertifikat.

Det här kommandot frågar först hanterad klusterresurs efter aktuella tumavtryck för servercertifikat och ansluter sedan till klustret med X509-certifikat. Ange namnet på resursgruppen för det hanterade klustret för att hämta anslutningsinformation, inklusive det fullständiga resurs-ID:t för det hanterade klustret. Se Ansluta till ett Service Fabric-hanterat kluster.

Det här kommandot ansluter sedan till ett kluster med ett X.509-certifikat.

Exempel 4: Ansluta till ett kluster med Azure Active Directory

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    AzureActiveDirectory = $True
    ServerCertThumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs

Det här kommandot ansluter till ett kluster med hjälp av Azure Active Directory-autentisering (AAD). Det här kommandot använder funktionen splatting i Windows PowerShell för att skapa en hash-tabell för parametrar och tillhandahåller dem sedan till cmdleten Connect-ServiceFabricCluster.

Exempel 5: Ansluta till ett kluster som skyddas med ett grupphanterat tjänstkonto

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    WindowsCredential = $True
    ClusterSpn = 'ServiceFabric/MyCluster.MyDomain.MyOrg'
}
PS C:\> Connect-ServiceFabricCluster @connectArgs

Det här kommandot använder funktionen splatting i Windows PowerShell för att skapa en hash-tabell för parametrar och tillhandahåller dem sedan till cmdleten Connect-ServiceFabricCluster.

Exempel 6: Ansluta till ett kluster som skyddas med datorkonton

PS C:\> $connectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    WindowsCredential = $True
}
PS C:\> Connect-ServiceFabricCluster @connectArgs

Det här kommandot ansluter till ett kluster som skyddas med datorkonton.

Exempel 7: Ansluta till ett kluster utan de primära kontrollerna

PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint -SkipChecks $True "ServiceFabric01.ContosoCloudApp.net:19000"

Det här kommandot skapar en anslutning till det angivna klustret.

Parametrar

-AllowNetworkConnectionOnly

Anger att cmdleten tillåter anslutning till klustret även när systemtjänsterna inte svarar så länge en underliggande nätverksanslutning kan upprättas.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuthTokenBufferSize

När du ansluter med AzureActiveDirectory anger du buffertstorleken som ska allokeras för hämtning av säkerhetstoken.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AzureActiveDirectory

Anger att Azure Active Directory ska användas för autentisering och auktorisering.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudServiceDNSNames

Den här parametern är endast avsedd för internt bruk.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudServiceName

Den här parametern är endast avsedd för internt bruk.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterSpn

Anger namnet på klustersäkerhetsobjektet som ska användas för Windows-autentiseringsuppgifter.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionEndpoint

Anger en matris med anslutningsslutpunkter för klustret i formatet ClusterAddress: ClientConnectionEndpoint, där ClusterAddress är IPv4-adressen, IPv6-adressen eller det fullständigt kvalificerade domännamnet (FQDN) för klusternoden som ska anslutas till och ClientConnectionEndpoint är klientanslutningsporten som anges i klustermanifestet. Omge IPv6-adresser inom hakparenteser ([]). Giltiga slutpunkter har följande formulär:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionInitializationTimeoutInSec

Anger tidsgränsen i sekunder för åtgärden.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DSTS

Den här parametern är endast avsedd för internt bruk.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FindType

Anger typen av FindValue för att söka efter certifikat i certifikatarkivet. Följande filtertyper stöds:

FindByThumbprint. Hitta certifikat med tumavtryck för certifikat.
FindBySubjectName. Sök certifikat i certifikatarkivet efter unikt ämnesnamn eller eget namn. När det unika ämnesnamnet anges i FindValue måste ämnesnamnet i certifikatet kodas i ASN-kodning på grund av en begränsning i internt Windows krypto-API. Det finns ingen sådan begränsning när ett eget namn anges i 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

Anger filtervärde för att söka efter ett certifikat i certifikatarkivet.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-GetMetadata

Vid anslutning med AzureActiveDirectory hämtar anonymt de metadata som används för tokenförvärv och försöker inte utföra någon autentisering.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthOperationTimeoutInSec

Anger tidsgränsen i sekunder för att skicka hälsorapporter. När en hälsoåtgärd överskrider tidsgränsen eller misslyckas med ett kommunikationsfel försöker hälsoklienten internt utföra åtgärden på nytt.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthReportRetrySendIntervalInSec

Anger intervallet i sekunder då hälsoklienten försöker skicka rapporterna som inte kunde skickas eller som ska sparas i hälsoarkivet. Det minsta värde som stöds är 1 sekund.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthReportSendIntervalInSec

Anger intervallet i sekunder då hälsoklienten skickar hälsorapporterna till hälsoarkivet. Om värdet är 0 skickar hälsoklienten rapporterna omedelbart.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Interactive

Anger om cmdleten fungerar interaktivt.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeepAliveIntervalInSec

Anger anslutningens keep-alive-period i sekunder. Det här intervallet förhindrar att en anslutning avslutas på grund av inaktivitet under åtgärder som körs asynkront.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MetaDataEndpoint

Den här parametern är endast avsedd för internt bruk.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionLocationCacheLimit

Anger antalet partitioner som cachelagrats för tjänstmatchning. Standardvärdet är 0, vilket innebär att det inte finns någon gräns.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecurityToken

När du ansluter med AzureActiveDirectory används den angivna säkerhetstoken direkt för autentisering och auktorisering i stället för att utföra interaktiv användarinloggning.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerCertThumbprint

Anger en matris med förväntade tumavtryck för klustersidan. Dessa tumavtryck används för att autentisera att cmdleten ansluter till slutpunkten för rätt kluster under x509- eller Azure Active Directory-ömsesidig autentisering.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerCommonName

Anger en matris med förväntade gemensamma namn för klustersidan. Dessa namn används för att autentisera att cmdleten ansluter till slutpunkten för rätt kluster under x509 eller Azure Active Directory ömsesidig autentisering.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceChangePollIntervalInSec

Anger intervallet i sekunder då infrastrukturresursklienten söker efter tjänständringar. Det här intervallet används av den gamla modellen med avsökningsbaserade meddelanden om ändring av tjänstadresser.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipChecks

Anger om du vill kringgå validering av svarstider för systemtjänster när du ansluter till klustret.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StoreLocation

Anger lagringsplatsen för ett certifikat. De acceptabla värdena för den här parametern är:

CurrentUser
LocalMachine

Type:	StoreLocation
Accepted values:	CurrentUser, LocalMachine
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StoreName

Anger namnet på certifikatarkivet för att läsa in klientcertifikatet.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WindowsCredential

Anger att cmdleten använder Windows-autentiseringsuppgifter för att ansluta till ett Service Fabric-kluster.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-X509Credential

Anger att cmdleten använder ett x509-certifikat för att utföra ömsesidig autentisering med ett Service Fabric-kluster.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

None

Utdata

System.Object

Connect-ServiceFabricCluster

Syntax

Description

Exempel

Exempel 1: Ansluta till ett kluster

Exempel 2: Ansluta till ett kluster med ett X.509-certifikat

Exempel 3: Ansluta till ett hanterat kluster med ett X.509-certifikat

Exempel 4: Ansluta till ett kluster med Azure Active Directory

Exempel 5: Ansluta till ett kluster som skyddas med ett grupphanterat tjänstkonto

Exempel 6: Ansluta till ett kluster som skyddas med datorkonton

Exempel 7: Ansluta till ett kluster utan de primära kontrollerna

Parametrar

-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

Indata

Utdata

Relaterade länkar

Ytterligare resurser