Megosztás a következőn keresztül:

Connect-ServiceFabricCluster

  • Referencia
Modul:
ServiceFabric

Kapcsolatot hoz létre Egy Service Fabric-fürthöz.

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

A Connect-ServiceFabricCluster parancsmag létrehoz egy kapcsolatot egy különálló Service Fabric-fürttel, amely lehetővé teszi a fürt felügyeleti műveleteinek futtatását. Miután csatlakozott egy fürthöz, megtekintheti a kapcsolat beállításait a Get-ServiceFabricClusterConnection parancsmaggal.

Service Fabric-fürtök kezeléséhez indítsa el a Windows PowerShellt a Futtatás rendszergazdaként beállítással.

Példák

1. példa: Csatlakozás fürthöz

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

Ez a parancs kapcsolatot hoz létre a megadott fürthöz.

2. példa: Csatlakozás fürthöz X.509-tanúsítvány használatával

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

Ez a parancs X.509-tanúsítvány használatával csatlakozik egy fürthöz. Ez a parancs a Windows PowerShell splatting funkciójával hoz létre egy kivonattáblát a paraméterekhez, majd ellátja őket a Connect-ServiceFabricCluster parancsmaggal.

3. példa: Csatlakozás felügyelt fürthöz X.509-tanúsítvány használatával

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

Megjegyzés: Felügyelt fürthöz való csatlakozáshoz a PowerShell "Az.ServiceFabric" és az "Az.Resources" modul szükséges a kiszolgálótanúsítvány ujjlenyomatainak lekérdezéséhez.

Ez a parancs először lekérdezi a felügyelt fürterőforrást az aktuális kiszolgálótanúsítvány ujjlenyomataihoz, majd X509-tanúsítvány használatával csatlakozik a fürthöz. Adja meg a felügyelt fürt erőforráscsoportjának nevét a kapcsolatadatok lekéréséhez, beleértve a felügyelt fürt teljes erőforrás-azonosítóját. Lásd: Csatlakozás Service Fabric által felügyelt fürthöz.

Ez a parancs ezután egy X.509-tanúsítvány használatával csatlakozik egy fürthöz.

4. példa: Csatlakozás fürthöz az Azure Active Directory használatával

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

Ez a parancs Azure Active Directory (AAD) hitelesítéssel csatlakozik egy fürthöz. Ez a parancs a Windows PowerShell splatting funkciójával hoz létre egy kivonattáblát a paraméterekhez, majd ellátja őket a Connect-ServiceFabricCluster parancsmaggal.

5. példa: Csatlakozás csoport által felügyelt szolgáltatásfiókkal védett fürthöz

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

Ez a parancs a Windows PowerShell splatting funkciójával hoz létre egy kivonattáblát a paraméterekhez, majd ellátja őket a Connect-ServiceFabricCluster parancsmaggal.

6. példa: Csatlakozás gépfiókokkal védett fürthöz

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

Ez a parancs egy számítógépfiókokkal védett fürthöz csatlakozik.

7. példa: Csatlakozás fürthöz az elsődleges ellenőrzések nélkül

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

Ez a parancs kapcsolatot hoz létre a megadott fürthöz.

Paraméterek

-AllowNetworkConnectionOnly

Azt jelzi, hogy a parancsmag akkor is lehetővé teszi a fürthöz való csatlakozást, ha a rendszerszolgáltatások nem válaszolnak, amíg létre lehet hozni egy mögöttes hálózati kapcsolatot.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AuthTokenBufferSize

Ha AzureActiveDirectorycsatlakozik, megadja a biztonsági jogkivonat beszerzéséhez lefoglalandó pufferméretet.

Típus:Int64
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AzureActiveDirectory

Megadja, hogy az Azure Active Directoryt használni kell a hitelesítéshez és az engedélyezéshez.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-CloudServiceDNSNames

Ez a paraméter csak belső használatra használható.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-CloudServiceName

Ez a paraméter csak belső használatra használható.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ClusterSpn

Megadja a Windows hitelesítő adatokhoz használandó fürtbiztonsági egyszerű nevet.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ConnectionEndpoint

A fürt kapcsolati végpontjainak tömbje a ClusterAddress: ClientConnectionEndpoint formátumban, ahol a ClusterAddress a fürtcsomópont IPv4-címe, IPv6-címe vagy teljes tartományneve (FQDN) a fürtjegyzékben megadott ügyfélkapcsolati port. Az IPv6-címeket szögletes zárójelekbe ([]) foglalja. Az érvényes végpontok az alábbi űrlappal rendelkeznek:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

Típus:String[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ConnectionInitializationTimeoutInSec

A művelet időtúllépési időtartamát adja meg másodpercben.

Típus:Double
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DSTS

Ez a paraméter csak belső használatra használható.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-FindType

Megadja, hogy milyen típusú FindValue a tanúsítványtárban való kereséshez. A következő szűrőtípusok támogatottak:

  • FindByThumbprint. Tanúsítvány keresése tanúsítvány ujjlenyomat alapján.
  • FindBySubjectName. A tanúsítványtárban a tulajdonos megkülönböztető neve vagy köznapi neve alapján kereshet tanúsítványt, ha a tulajdonos megkülönböztető nevét FindValueadja meg, a tanúsítvány tulajdonosnevét ASN-kódolásban kell kódolni a natív Windows crypto API korlátozása miatt. Nincs ilyen korlátozás, ha a közös nevet FindValueadja meg.
  • FindBySubjectDistinguishedName
  • FindByIssuerName
  • FindByIssuerDistinguishedName
  • FindBySerialNumber
  • FindByTimeValid
  • FindByTimeNotYetValid
  • FindByTimeExpired
  • FindByTemplateName
  • FindByApplicationPolicy
  • FindByCertificatePolicy
  • FindByExtension
  • FindByKeyUsage
  • FindBySubjectKeyIdentifier
Típus:X509FindType
Elfogadott értékek:FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-FindValue

Szűrőértéket ad meg a tanúsítványtárban való kereséshez.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-GetMetadata

Ha AzureActiveDirectorycsatlakozik, névtelenül lekéri a jogkivonatok beszerzéséhez használt metaadatokat, és nem kísérli meg a hitelesítést.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-HealthOperationTimeoutInSec

Az állapotjelentések küldéséhez másodpercben megadott időtúllépési időtartamot adja meg. Ha egy állapotművelet túllépi vagy kommunikációs hibával meghiúsul, az állapotügyfél belsőleg újrapróbálkozza a műveletet.

Típus:Double
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-HealthReportRetrySendIntervalInSec

Azt az időközt adja meg másodpercben, amikor az állapotügyfél újra megpróbálja elküldeni azokat a jelentéseket, amelyeket nem sikerült elküldeni vagy tárolni az állapottárolóban. A minimális támogatott érték 1 másodperc.

Típus:Double
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-HealthReportSendIntervalInSec

Megadja azt az időközt másodpercben, amikor az állapotügyfél elküldi az állapotjelentéseket az állapottárolónak. Ha 0 értékre van állítva, az állapotügyfél azonnal elküldi a jelentéseket.

Típus:Double
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Interactive

Jelzi, hogy a parancsmag interaktívan működik-e.

Típus:Boolean
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-KeepAliveIntervalInSec

A kapcsolat életben tartásának időtartamát adja meg másodpercben. Ez az időköz megakadályozza, hogy a kapcsolat megszakadjon, mert az aszinkron módon futó műveletek során inaktivitás történik.

Típus:Double
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MetaDataEndpoint

Ez a paraméter csak belső használatra használható.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-PartitionLocationCacheLimit

Megadja a szolgáltatásfeloldáshoz gyorsítótárazott partíciók számát. Az alapértelmezett érték 0, ami nem jelent korlátot.

Típus:Int64
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SecurityToken

Ha AzureActiveDirectorycsatlakozik, a rendszer a megadott biztonsági jogkivonatot közvetlenül a hitelesítéshez és engedélyezéshez használja, nem pedig interaktív felhasználói bejelentkezést.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ServerCertThumbprint

A fürtoldal várt ujjlenyomatainak tömbje. Ezek az ujjlenyomatok hitelesítik, hogy a parancsmag a megfelelő fürt végpontjához csatlakozik az x509 vagy az Azure Active Directory kölcsönös hitelesítése során.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ServerCommonName

A fürtoldal várt gyakori neveinek tömbje. Ezek a nevek hitelesítik, hogy a parancsmag a megfelelő fürt végponthoz csatlakozik az x509 vagy az Azure Active Directory kölcsönös hitelesítése során.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ServiceChangePollIntervalInSec

Megadja azt az időközt másodpercben, amikor a hálóügyfél lekérdezi a szolgáltatás változásait. Ezt az időközt a lekérdezésalapú szolgáltatáscím-változási értesítések régi modellje használja.

Típus:Double
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SkipChecks

Azt jelzi, hogy megkerüli a rendszerszolgáltatás válaszképesség-ellenőrzési ellenőrzését a fürthöz való csatlakozáskor.

Típus:Boolean
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-StoreLocation

A tanúsítvány tárolási helyét adja meg. A paraméter elfogadható értékei a következők:

  • CurrentUser
  • LocalMachine
Típus:StoreLocation
Elfogadott értékek:CurrentUser, LocalMachine
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-StoreName

Megadja annak a tanúsítványtárolónak a nevét, amely betölti az ügyféltanúsítványt.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TimeoutSec

A művelet időtúllépési időtartamát adja meg másodpercben.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WindowsCredential

Azt jelzi, hogy a parancsmag Windows-hitelesítő adatokkal csatlakozik egy Service Fabric-fürthöz.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-X509Credential

Azt jelzi, hogy a parancsmag x509-tanúsítványt használ a Service Fabric-fürttel való kölcsönös hitelesítéshez.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

None

Kimenetek

System.Object