Connect-ServiceFabricCluster

Reference

Modul:: ServiceFabric

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

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

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á funkci splatting Windows PowerShell k vytvoření tabulky hash pro parametry a pak je poskytne 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 PowerShell Az.ServiceFabric a Az.Resources k dotazování na kryptografické otisky certifikátů serveru.

Tento příkaz nejprve dotazuje spravovaný prostředek clusteru pro aktuální kryptografické otisky 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á funkci splatting Windows PowerShell k vytvoření tabulky hash pro parametry a pak je poskytne 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á funkci splatting Windows PowerShell k vytvoření tabulky hash pro parametry a pak je poskytne 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í.

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

-AuthTokenBufferSize

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

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

-AzureActiveDirectory

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

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

-CloudServiceDNSNames

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

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

-CloudServiceName

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

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

-ClusterSpn

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

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

-ConnectionInitializationTimeoutInSec

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

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

-DSTS

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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. Prohledávat 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 souboru FindValue uveden rozlišující název subjektu, musí být název subjektu v certifikátu 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 ve službě FindValue uveden běžný název.
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

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

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

-GetMetadata

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

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

-HealthOperationTimeoutInSec

Určuje dobu vypršení časového limitu v sekundách pro odesílání zpráv o stavu. Pokud dojde k vypršení časového limitu operace stavu nebo selhání s chybou komunikace, klient stavu operaci interně opakuje.

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

-HealthReportRetrySendIntervalInSec

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

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

-HealthReportSendIntervalInSec

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

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

-Interactive

Určuje, jestli rutina interaktivně funguje.

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

-KeepAliveIntervalInSec

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

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

-MetaDataEndpoint

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

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

-PartitionLocationCacheLimit

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

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

-SecurityToken

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-ServiceChangePollIntervalInSec

Určuje interval v sekundách, ve kterém klient infrastruktury dotazuje změny služby. Tento interval používá starý model oznámení o změnách adres na základě hlasování.

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

-SkipChecks

Označuje, že se při připojování ke clusteru vynechá ověření rychlosti odezvy systémové služby.

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

-StoreLocation

Určuje umístění úložiště certifikátu. Tento parametr přijímá tyto hodnoty:

Currentuser
LocalMachine

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

-StoreName

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

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

-TimeoutSec

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

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

-WindowsCredential

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

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

-X509Credential

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

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

Vstupy

None

Výstupy

System.Object

Connect-ServiceFabricCluster

Syntax

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