Dela via


Connect-ServiceFabricCluster

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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AuthTokenBufferSize

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

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AzureActiveDirectory

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CloudServiceDNSNames

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

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CloudServiceName

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ClusterSpn

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConnectionInitializationTimeoutInSec

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

Typ:Double
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DSTS

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Typ:X509FindType
Godkända värden:FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FindValue

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Double
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Double
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Double
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Interactive

Anger om cmdleten fungerar interaktivt.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Double
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MetaDataEndpoint

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Double
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkipChecks

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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StoreLocation

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

  • CurrentUser
  • LocalMachine
Typ:StoreLocation
Godkända värden:CurrentUser, LocalMachine
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StoreName

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

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

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WindowsCredential

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-X509Credential

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

System.Object