Connect-ServiceFabricCluster

Odwołanie

Moduł:: ServiceFabric

Tworzy połączenie z klastrem usługi Service Fabric.

Składnia

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>]

Opis

Polecenie cmdlet Connect-ServiceFabricCluster tworzy połączenie z autonomicznym klastrem usługi Service Fabric, które umożliwia uruchamianie akcji zarządzania dla tego klastra. Po nawiązaniu połączenia z klastrem możesz wyświetlić ustawienia połączenia przy użyciu polecenia cmdlet Get-ServiceFabricClusterConnection .

Aby zarządzać klastrami usługi Service Fabric, uruchom Windows PowerShell przy użyciu opcji Uruchom jako administrator.

Przykłady

Przykład 1. Nawiązywanie połączenia z klastrem

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

To polecenie tworzy połączenie z określonym klastrem.

Przykład 2. Nawiązywanie połączenia z klastrem przy użyciu certyfikatu 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

To polecenie łączy się z klastrem przy użyciu certyfikatu X.509. To polecenie używa funkcji splattingu Windows PowerShell do utworzenia tabeli skrótów dla parametrów, a następnie dostarcza je do polecenia cmdlet Connect-ServiceFabricCluster.

Przykład 3. Nawiązywanie połączenia z klastrem zarządzanym przy użyciu certyfikatu 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

Uwaga: Nawiązywanie połączenia z klastrem zarządzanym wymaga modułów programu PowerShell "Az.ServiceFabric" i "Az.Resources", aby wykonywać zapytania dotyczące odcisków palca certyfikatu serwera.

To polecenie najpierw wykonuje zapytania dotyczące zasobu klastra zarządzanego dla bieżących odcisków palca certyfikatu serwera, a następnie łączy się z klastrem przy użyciu certyfikatu X509. Podaj nazwę grupy zasobów dla klastra zarządzanego, aby pobrać informacje o połączeniu, w tym pełny identyfikator zasobu dla klastra zarządzanego. Zobacz Nawiązywanie połączenia z klastrem zarządzanym usługi Service Fabric.

To polecenie następnie łączy się z klastrem przy użyciu certyfikatu X.509.

Przykład 4. Nawiązywanie połączenia z klastrem przy użyciu usługi Azure Active Directory

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

To polecenie łączy się z klastrem przy użyciu uwierzytelniania usługi Azure Active Directory (AAD). To polecenie używa funkcji splattingu Windows PowerShell do utworzenia tabeli skrótów dla parametrów, a następnie dostarcza je do polecenia cmdlet Connect-ServiceFabricCluster.

Przykład 5. Nawiązywanie połączenia z klastrem zabezpieczonym przy użyciu konta usługi zarządzanego przez grupę

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

To polecenie używa funkcji splattingu Windows PowerShell do utworzenia tabeli skrótów dla parametrów, a następnie dostarcza je do polecenia cmdlet Connect-ServiceFabricCluster.

Przykład 6. Nawiązywanie połączenia z klastrem zabezpieczonym przy użyciu kont maszyn

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

To polecenie łączy się z klastrem zabezpieczonym przy użyciu kont maszyn.

Przykład 7. Nawiązywanie połączenia z klastrem bez kontroli podstawowych

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

To polecenie tworzy połączenie z określonym klastrem.

Parametry

-AllowNetworkConnectionOnly

Wskazuje, że polecenie cmdlet umożliwia nawiązywanie połączenia z klastrem nawet wtedy, gdy usługi systemowe nie odpowiadają, o ile można ustanowić bazowe połączenie sieciowe.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-AuthTokenBufferSize

Podczas nawiązywania połączenia z usługą AzureActiveDirectory określa rozmiar buforu do przydzielenia na potrzeby pozyskiwania tokenu zabezpieczającego.

Typ:	Int64
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-AzureActiveDirectory

Określa, że usługa Azure Active Directory powinna być używana do uwierzytelniania i autoryzacji.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CloudServiceDNSNames

Ten parametr jest przeznaczony tylko do użytku wewnętrznego.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CloudServiceName

Ten parametr jest przeznaczony tylko do użytku wewnętrznego.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ClusterSpn

Określa nazwę główną zabezpieczeń klastra do użycia dla poświadczeń systemu Windows.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ConnectionEndpoint

Określa tablicę punktów końcowych połączenia dla klastra w formacie ClusterAddress: ClientConnectionEndpoint, gdzie ClusterAddress jest adresem IPv4, adresem IPv6 lub w pełni kwalifikowaną nazwą domeny (FQDN) węzła klastra w celu nawiązania połączenia z węzłem i ClientConnectionEndpoint jest portem połączenia klienta określonym w manifeście klastra. Ujmij adresy IPv6 w nawiasach kwadratowych ([]). Prawidłowe punkty końcowe mają następujący formularz:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

Typ:	String[]
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ConnectionInitializationTimeoutInSec

Określa limit czasu dla operacji w sekundach.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DSTS

Ten parametr jest przeznaczony tylko do użytku wewnętrznego.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FindType

Określa typ elementu FindValue do wyszukiwania certyfikatu w magazynie certyfikatów. Obsługiwane są następujące typy filtrów:

FindByThumbprint. Znajdź certyfikat według odcisku palca certyfikatu.
FindBySubjectName. Certyfikat wyszukiwania w magazynie certyfikatów według nazwy wyróżniającej podmiotu lub nazwy pospolitej, gdy nazwa wyróżniająca podmiotu jest podana w findValue, nazwa podmiotu w certyfikacie musi być zakodowana w kodowaniu ASN ze względu na ograniczenie w natywnym interfejsie API kryptograficznym systemu Windows. Nie ma takiego ograniczenia, gdy nazwa pospolita jest podana w funkcji FindValue.
FindBySubjectDistinguishedName
FindByIssuerName
FindByIssuerDistinguishedName
FindBySerialNumber
FindByTimeValid
FindByTimeNotYetValid
FindByTimeExpired
FindByTemplateName
FindByApplicationPolicy
FindByCertificatePolicy
FindByExtension
FindByKeyUsage
FindBySubjectKeyIdentifier

Typ:	X509FindType
Dopuszczalne wartości:	FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FindValue

Określa wartość filtru do wyszukiwania certyfikatu w magazynie certyfikatów.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-GetMetadata

Podczas nawiązywania połączenia z usługą AzureActiveDirectory anonimowo pobiera metadane używane do pozyskiwania tokenu i nie podejmuje próby uwierzytelnienia.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-HealthOperationTimeoutInSec

Określa limit czasu w sekundach dla wysyłania raportów o kondycji. W przypadku przekroczenia limitu czasu operacji kondycji lub niepowodzenia z powodu błędu komunikacji klient kondycji wewnętrznie ponawia próbę operacji.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-HealthReportRetrySendIntervalInSec

Określa interwał w sekundach, w którym klient kondycji ponawia próby wysyłania raportów, które nie powiodły się lub mają być utrwalane w magazynie kondycji. Minimalna obsługiwana wartość to 1 sekunda.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-HealthReportSendIntervalInSec

Określa interwał w sekundach, w którym klient kondycji wysyła raporty o kondycji do magazynu kondycji. Jeśli ustawiono wartość 0, klient kondycji natychmiast wyśle raporty.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Interactive

Wskazuje, czy polecenie cmdlet działa interaktywnie.

Typ:	Boolean
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-KeepAliveIntervalInSec

Określa okres utrzymania aktywności połączenia w sekundach. Ten interwał uniemożliwia zakończenie połączenia z powodu braku aktywności podczas operacji uruchamianych asynchronicznie.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-MetaDataEndpoint

Ten parametr jest przeznaczony tylko do użytku wewnętrznego.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-PartitionLocationCacheLimit

Określa liczbę partycji buforowanych na potrzeby rozpoznawania usługi. Wartość domyślna to 0, co oznacza brak limitu.

Typ:	Int64
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SecurityToken

Podczas nawiązywania połączenia z usługą AzureActiveDirectory określony token zabezpieczający jest używany bezpośrednio do uwierzytelniania i autoryzacji zamiast logowania użytkownika interakcyjnego.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ServerCertThumbprint

Określa tablicę oczekiwanych odcisków palca po stronie klastra. Te odciski palca są używane do uwierzytelniania, że polecenie cmdlet łączy się z punktem końcowym poprawnego klastra podczas wzajemnego uwierzytelniania x509 lub Azure Active Directory.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ServerCommonName

Określa tablicę oczekiwanych nazw pospolitych po stronie klastra. Te nazwy są używane do uwierzytelniania, że polecenie cmdlet łączy się z punktem końcowym poprawnego klastra podczas wzajemnego uwierzytelniania x509 lub Azure Active Directory.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ServiceChangePollIntervalInSec

Określa interwał w sekundach, w którym klient sieci szkieletowej sonduje zmiany usługi. Ten interwał jest używany przez stary model powiadomień o zmianie adresu usługi opartej na ankietach.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SkipChecks

Wskazuje obejście sprawdzania poprawności odpowiedzi usługi systemu podczas nawiązywania połączenia z klastrem.

Typ:	Boolean
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-StoreLocation

Określa lokalizację magazynu certyfikatu. Dopuszczalne wartości dla tego parametru to:

Currentuser
Localmachine

Typ:	StoreLocation
Dopuszczalne wartości:	CurrentUser, LocalMachine
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-StoreName

Określa nazwę magazynu certyfikatów do załadowania certyfikatu klienta.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Typ:	Int32
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WindowsCredential

Wskazuje, że polecenie cmdlet używa poświadczeń systemu Windows do nawiązywania połączenia z klastrem usługi Service Fabric.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-X509Credential

Wskazuje, że polecenie cmdlet używa certyfikatu x509 do wzajemnego uwierzytelniania z klastrem usługi Service Fabric.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

None

Dane wyjściowe

System.Object

Udostępnij za pośrednictwem

Connect-ServiceFabricCluster

Składnia

Opis

Przykłady

Przykład 1. Nawiązywanie połączenia z klastrem

Przykład 2. Nawiązywanie połączenia z klastrem przy użyciu certyfikatu X.509

Przykład 3. Nawiązywanie połączenia z klastrem zarządzanym przy użyciu certyfikatu X.509

Przykład 4. Nawiązywanie połączenia z klastrem przy użyciu usługi Azure Active Directory

Przykład 5. Nawiązywanie połączenia z klastrem zabezpieczonym przy użyciu konta usługi zarządzanego przez grupę

Przykład 6. Nawiązywanie połączenia z klastrem zabezpieczonym przy użyciu kont maszyn

Przykład 7. Nawiązywanie połączenia z klastrem bez kontroli podstawowych

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

Dane wejściowe

Dane wyjściowe

Linki powiązane

Dodatkowe zasoby