Connect-ServiceFabricCluster

Синтаксис

Default

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

Windows

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

X509

Connect-ServiceFabricCluster
    [-ConnectionEndpoint] <String[]>
    -FindType <X509FindType>
    -FindValue <String>
    [-AllowNetworkConnectionOnly]
    [-X509Credential]
    [-ServerCommonName <String[]>]
    [-ServerCertThumbprint <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>]

Dsts

Connect-ServiceFabricCluster
    [-ConnectionEndpoint] <String[]>
    -MetaDataEndpoint <String>
    [-AllowNetworkConnectionOnly]
    [-ServerCommonName <String[]>]
    [-ServerCertThumbprint <String[]>]
    [-DSTS]
    [-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>]

Aad

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

Описание

Примеры

Пример 1: Подключение к кластеру

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

Пример 2: Подключение к кластеру с помощью сертификата 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

Пример 3: Подключение к управляемому кластеру с помощью сертификата 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

Пример 4: Подключение к кластеру с помощью Azure Active Directory

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

Пример 5: Подключение к кластеру, защищенному с помощью сервисной учетной записи, управляемой группой

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

Пример 6: Подключение к кластеру, защищенному учетными записями компьютеров

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

Пример 7: Подключение к кластеру без основных проверок

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

Параметры

-AllowNetworkConnectionOnly

Указывает, что командлет разрешает подключение к кластеру, даже если системные службы не отвечают, при условии установки базового сетевого подключения.

Свойства параметра

Наборы параметров

-AuthTokenBufferSize

При подключении с AzureActiveDirectory указывает размер буфера, выделяемого для получения маркера безопасности.

Свойства параметра

Наборы параметров

-AzureActiveDirectory

Указывает, что для проверки подлинности и авторизации следует использовать Azure Active Directory.

Свойства параметра

Наборы параметров

-CloudServiceDNSNames

Этот параметр предназначен только для внутреннего использования.

Свойства параметра

Наборы параметров

-CloudServiceName

Этот параметр предназначен только для внутреннего использования.

Свойства параметра

Наборы параметров

-ClusterSpn

Указывает имя участника безопасности кластера, используемое для учетных данных Windows.

Свойства параметра

Наборы параметров

-ConnectionEndpoint

Указывает массив конечных точек подключения для кластера в формате ClusterAddress: ClientConnectionEndpoint, где ClusterAddress — это IPv4-адрес, IPv6-адрес или полное доменное имя (FQDN) узла кластера, к которому необходимо подключиться, а ClientConnectionEndpoint — это порт подключения клиента, указанный в манифесте кластера. Заключите адреса IPv6 в квадратные скобки ([]). Допустимые эндпоинты имеют следующий вид:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

Свойства параметра

Наборы параметров

-ConnectionInitializationTimeoutInSec

Указывает период ожидания операции в секундах.

Свойства параметра

Наборы параметров

-DSTS

Этот параметр предназначен только для внутреннего использования.

Свойства параметра

Наборы параметров

-FindType

Указывает тип FindValue для поиска сертификата в хранилище сертификатов. Поддерживаются следующие типы фильтров:

• FindByThumbprint. Найдите сертификат по отпечатку сертификата.
• FindBySubjectName. Поиск сертификата в хранилище сертификатов по отличительному имени субъекта или общему имени, если отличительное имя субъекта указано в FindValue, имя субъекта в сертификате должно быть закодировано в кодировке ASN из-за ограничения в собственном API шифрования Windows. Такого ограничения нет, если в FindValue указано общее имя.
• FindBySubjectDistinctedName (НайтиПоSubjectDistinctedName)
• FindByIssuerName (НайтиПоИмяЭмитента)
• FindByIssuerDistinctedName (НайтиПоЭмитентуОтличительномуИмени)
• FindBySerialNumber (НайтиПоСерийному Номеру)
• FindByTimeValid (НайтиПоВремениДействительно)
• FindByTimeNotYetValid
• FindByTimeExpired
• FindByTemplateName (НайтиПоШаблонуName)
• FindByApplicationPolicy (Найти поApplicationPolicy
• Политика FindByCertificate
• FindByExtension (НайтиПоРасширению)
• FindByKeyUsage (НайтиПоКлючуИспользованию)
• FindBySubjectKeyIdentifier (НайтиПоSubjectKeyIdentifier)

Свойства параметра

Наборы параметров

-FindValue

Указывает значение фильтра для поиска сертификата в хранилище сертификатов.

Свойства параметра

Наборы параметров

-GetMetadata

При подключении к AzureActiveDirectory анонимно получает метаданные, используемые для получения маркеров, и не пытается выполнить проверку подлинности.

Свойства параметра

Наборы параметров

-HealthOperationTimeoutInSec

Указывает период ожидания (в секундах) для отправки отчетов о работоспособности. Если время ожидания операции работоспособности истекает или происходит сбой с ошибкой связи, клиент работоспособности внутренне повторяет операцию.

Свойства параметра

Наборы параметров

-HealthReportRetrySendIntervalInSec

Указывает интервал (в секундах), через который клиент работоспособности повторяет попытку отправки отчетов, которые не удалось отправить или которые должны быть сохранены в хранилище данных о работоспособности. Минимальное поддерживаемое значение — 1 секунда.

Свойства параметра

Наборы параметров

-HealthReportSendIntervalInSec

Указывает интервал в секундах, с которым клиент работоспособности отправляет отчеты о работоспособности в хранилище данных о работоспособности. Если задано значение 0, клиент работоспособности будет отправлять отчеты немедленно.

Свойства параметра

Наборы параметров

-Interactive

Указывает, работает ли командлет в интерактивном режиме.

Свойства параметра

Наборы параметров

-KeepAliveIntervalInSec

Указывает период проверки активности подключения в секундах. Этот интервал предотвращает прерывание соединения из-за бездействия во время операций, которые выполняются асинхронно.

Свойства параметра

Наборы параметров

-MetaDataEndpoint

Этот параметр предназначен только для внутреннего использования.

Свойства параметра

Наборы параметров

-PartitionLocationCacheLimit

Указывает количество секций, кэшируемых для разрешения службы. Значение по умолчанию равно 0, что означает отсутствие ограничений.

Свойства параметра

Наборы параметров

-SecurityToken

При подключении к AzureActiveDirectory указанный маркер безопасности используется непосредственно для проверки подлинности и авторизации, а не для интерактивного входа пользователя.

Свойства параметра

Наборы параметров

-ServerCertThumbprint

Указывает массив ожидаемых отпечатков для стороны кластера. Эти отпечатки используются для проверки подлинности того, что командлет подключается к конечной точке нужного кластера во время взаимной проверки подлинности x509 или Azure Active Directory.

Свойства параметра

Наборы параметров

-ServerCommonName

Указывает массив ожидаемых общих имен для стороны кластера. Эти имена используются для проверки подлинности того, что командлет подключается к конечной точке нужного кластера во время взаимной проверки подлинности x509 или Azure Active Directory.

Свойства параметра

Наборы параметров

-ServiceChangePollIntervalInSec

Указывает интервал в секундах, с которым клиент структуры опрашивает изменения службы. Этот интервал используется в старой модели уведомлений об изменении адреса службы на основе опроса.

Свойства параметра

Наборы параметров

-SkipChecks

Указывает на обход проверок отзывчивости системных служб при подключении к кластеру.

Свойства параметра

Наборы параметров

-StoreLocation

Указывает место хранения сертификата. Допустимые значения для этого параметра:

• Текущий пользователь
• LocalMachine

Свойства параметра

Наборы параметров

-StoreName

Указывает имя хранилища сертификатов для загрузки сертификата клиента.

Свойства параметра

Наборы параметров

-TimeoutSec

Указывает период ожидания операции в секундах.

Свойства параметра

Наборы параметров

-WindowsCredential

Указывает, что командлет использует учетные данные Windows для подключения к кластеру Service Fabric.

Свойства параметра

Наборы параметров

-X509Credential

Указывает, что командлет использует сертификат x509 для выполнения взаимной проверки подлинности с кластером Service Fabric.

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

None

Выходные данные

System.Object

Связанные ссылки

• Get-ServiceFabricClusterConnection
• Test-ServiceFabricClusterConnection