Connect-ServiceFabricCluster
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