Connect-ServiceFabricCluster

Reference

Modul:: ServiceFabric

Vytvoří připojení ke clusteru Service Fabric.

Syntaxe

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

Rutina Connect-ServiceFabricCluster vytvoří připojení k samostatnému clusteru Service Fabric, který umožňuje spouštět akce správy pro tento cluster. Po připojení ke clusteru můžete zobrazit nastavení připojení pomocí rutiny Get-ServiceFabricClusterConnection.

Pokud chcete spravovat clustery Service Fabric, spusťte Windows PowerShell pomocí možnosti Spustit jako správce.

Příklady

Příklad 1: Připojení ke clusteru

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

Tento příkaz vytvoří připojení k zadanému clusteru.

Příklad 2: Připojení ke clusteru pomocí certifikátu X.509

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

Tento příkaz se připojí ke clusteru pomocí certifikátu X.509. Tento příkaz používá k vytvoření tabulky hash pro parametry funkci splatting v prostředí Windows PowerShell a pak je dodává rutině Connect-ServiceFabricCluster.

Příklad 3: Připojení ke spravovanému clusteru pomocí certifikátu X.509

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

Poznámka: Připojení ke spravovanému clusteru vyžaduje moduly Az.ServiceFabric a Az.Resources pro dotazování na kryptografické otisky certifikátů serveru.

Tento příkaz nejprve dotazuje prostředek spravovaného clusteru na kryptografické otisky aktuálního certifikátu serveru a pak se připojí ke clusteru pomocí certifikátu X509. Zadejte název skupiny prostředků pro spravovaný cluster pro načtení informací o připojení, včetně úplného ID prostředku spravovaného clusteru. Viz Připojení ke spravovanému clusteru Service Fabric.

Tento příkaz se pak připojí ke clusteru pomocí certifikátu X.509.

Příklad 4: Připojení ke clusteru pomocí Azure Active Directory

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

Tento příkaz se připojí ke clusteru pomocí ověřování Azure Active Directory (AAD). Tento příkaz používá k vytvoření tabulky hash pro parametry funkci splatting v prostředí Windows PowerShell a pak je dodává rutině Connect-ServiceFabricCluster.

Příklad 5: Připojení ke clusteru zabezpečenému pomocí účtu služby spravované skupiny

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

Tento příkaz používá k vytvoření tabulky hash pro parametry funkci splatting v prostředí Windows PowerShell a pak je dodává rutině Connect-ServiceFabricCluster.

Příklad 6: Připojení ke clusteru zabezpečenému pomocí účtů počítačů

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

Tento příkaz se připojí ke clusteru zabezpečenému pomocí účtů počítačů.

Příklad 7: Připojení ke clusteru bez primárních kontrol

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

Tento příkaz vytvoří připojení k zadanému clusteru.

Parametry

-AllowNetworkConnectionOnly

Označuje, že rutina umožňuje připojení ke clusteru i v případě, že systémové služby nereagují, pokud je možné navázat základní síťové připojení.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AuthTokenBufferSize

Při připojování pomocí AzureActiveDirectoryurčuje velikost vyrovnávací paměti, která se má přidělit pro získání tokenu zabezpečení.

Typ:	Int64
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AzureActiveDirectory

Určuje, že se má azure Active Directory použít k ověřování a autorizaci.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CloudServiceDNSNames

Tento parametr je určen pouze pro interní použití.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CloudServiceName

Tento parametr je určen pouze pro interní použití.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ClusterSpn

Určuje hlavní název zabezpečení clusteru, který se má použít pro přihlašovací údaje systému Windows.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ConnectionEndpoint

Určuje pole koncových bodů připojení pro cluster ve formátu ClusterAddress: ClientConnectionEndpoint, kde ClusterAddress je adresa IPv4, adresa IPv6 nebo plně kvalifikovaný název domény (FQDN) uzlu clusteru pro připojení a ClientConnectionEndpoint je port připojení klienta zadaný v manifestu clusteru. Uzavřete adresy IPv6 do hranatých závorek ([]). Platné koncové body mají následující formulář:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

Typ:	String[]
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ConnectionInitializationTimeoutInSec

Určuje časový limit operace v sekundách.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DSTS

Tento parametr je určen pouze pro interní použití.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-FindType

Určuje typ FindValue pro vyhledávání certifikátu v úložišti certifikátů. Podporují se následující typy filtrů:

FindByThumbprint. Vyhledejte certifikát podle kryptografického otisku certifikátu.
FindBySubjectName. Prohledat certifikát v úložišti certifikátů podle rozlišujícího názvu subjektu nebo běžného názvu, pokud je v FindValue, název subjektu v certifikátu musí být kódován v kódování ASN kvůli omezení v nativním kryptografickém rozhraní API systému Windows. Neexistuje žádné takové omezení, pokud je v FindValue uveden běžný název.
FindBySubjectDistinguishedName
FindByIssuerName
FindByIssuerDistinguishedName
FindBySerialNumber
FindByTimeValid
FindByTimeNotYetValid
FindByTimeExpired
FindByTemplateName
FindByApplicationPolicy
FindByCertificatePolicy
FindByExtension
FindByKeyUsage
FindBySubjectKeyIdentifier

Typ:	X509FindType
Přípustné hodnoty:	FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-FindValue

Určuje hodnotu filtru pro vyhledávání certifikátu v úložišti certifikátů.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-GetMetadata

Při připojování pomocí AzureActiveDirectory, anonymně načte metadata používaná k získání tokenu a nepokoušá se o ověření.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-HealthOperationTimeoutInSec

Určuje časový limit pro odesílání zpráv o stavu v sekundách. Když vyprší časový limit operace stavu nebo selže s chybou komunikace, klient stavu interně opakuje operaci.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-HealthReportRetrySendIntervalInSec

Určuje interval v sekundách, ve kterém klient stavu opakuje odesílání sestav, které se nepodařilo odeslat nebo zachovat v úložišti stavu. Minimální podporovaná hodnota je 1 sekunda.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-HealthReportSendIntervalInSec

Určuje interval v sekundách, ve kterém klient stavu odesílá sestavy o stavu do úložiště stavu. Pokud je nastavená hodnota 0, klient stavu okamžitě odešle sestavy.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Interactive

Určuje, jestli rutina funguje interaktivně.

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-KeepAliveIntervalInSec

Určuje dobu uchování připojení v sekundách. Tento interval zabraňuje ukončení připojení kvůli nečinnosti během operací, které běží asynchronně.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MetaDataEndpoint

Tento parametr je určen pouze pro interní použití.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PartitionLocationCacheLimit

Určuje počet oddílů uložených v mezipaměti pro řešení služeb. Výchozí hodnota je 0, což značí žádný limit.

Typ:	Int64
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SecurityToken

Při připojování pomocí AzureActiveDirectoryse zadaný token zabezpečení používá přímo k ověřování a autorizaci místo interaktivního přihlášení uživatele.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ServerCertThumbprint

Určuje pole očekávaných kryptografických otisků na straně clusteru. Tyto kryptografické otisky slouží k ověření, že se rutina připojuje ke koncovému bodu správného clusteru během vzájemného ověřování x509 nebo Azure Active Directory.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ServerCommonName

Určuje pole očekávaných běžných názvů pro stranu clusteru. Tyto názvy slouží k ověření, že se rutina připojuje ke koncovému bodu správného clusteru během vzájemného ověřování x509 nebo Azure Active Directory.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ServiceChangePollIntervalInSec

Určuje interval v sekundách, ve kterém se klient prostředků infrastruktury dotazuje na změny služby. Tento interval používá starý model oznámení o změně adresy služby založené na dotazech.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SkipChecks

Označuje, že se má při připojování ke clusteru obejít kontroly odezvy systémových služeb.

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StoreLocation

Určuje umístění úložiště certifikátu. Přijatelné hodnoty pro tento parametr jsou:

CurrentUser
LocalMachine

Typ:	StoreLocation
Přípustné hodnoty:	CurrentUser, LocalMachine
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StoreName

Určuje název úložiště certifikátů pro načtení klientského certifikátu.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TimeoutSec

Určuje časový limit operace v sekundách.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WindowsCredential

Označuje, že rutina používá přihlašovací údaje Windows pro připojení ke clusteru Service Fabric.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-X509Credential

Označuje, že rutina používá certifikát x509 k provedení vzájemného ověřování s clusterem Service Fabric.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

None

Výstupy

System.Object

Sdílet prostřednictvím

Connect-ServiceFabricCluster

Syntaxe

Description

Příklady

Příklad 1: Připojení ke clusteru

Příklad 2: Připojení ke clusteru pomocí certifikátu X.509

Příklad 3: Připojení ke spravovanému clusteru pomocí certifikátu X.509

Příklad 4: Připojení ke clusteru pomocí Azure Active Directory

Příklad 5: Připojení ke clusteru zabezpečenému pomocí účtu služby spravované skupiny

Příklad 6: Připojení ke clusteru zabezpečenému pomocí účtů počítačů

Příklad 7: Připojení ke clusteru bez primárních kontrol

Parametry

-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

Vstupy

Výstupy

Související odkazy

Další materiály