Connect-ServiceFabricCluster

Sintaxis

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

Description

Ejemplos

Ejemplo 1: Conexión a un clúster

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

Ejemplo 2: Conexión a un clúster mediante un certificado 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

Ejemplo 3: Conexión a un clúster administrado mediante un certificado 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

Ejemplo 4: Conexión a un clúster mediante Azure Active Directory

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

Ejemplo 5: Conexión a un clúster protegido con una cuenta de servicio administrada por grupo

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

Ejemplo 6: Conexión a un clúster protegido con cuentas de máquina

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

Ejemplo 7: Conexión a un clúster sin las comprobaciones principales

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

Parámetros

-AllowNetworkConnectionOnly

Indica que el cmdlet permite conectarse al clúster incluso cuando los servicios del sistema no responden siempre que se pueda establecer una conexión de red subyacente.

Propiedades de parámetro

Conjuntos de parámetros

-AuthTokenBufferSize

Al conectarse con AzureActiveDirectory, especifica el tamaño del búfer que se va a asignar para la adquisición de tokens de seguridad.

Propiedades de parámetro

Conjuntos de parámetros

-AzureActiveDirectory

Especifica que Se debe usar Azure Active Directory para la autenticación y autorización.

Propiedades de parámetro

Conjuntos de parámetros

-CloudServiceDNSNames

Este parámetro es solo para uso interno.

Propiedades de parámetro

Conjuntos de parámetros

-CloudServiceName

Este parámetro es solo para uso interno.

Propiedades de parámetro

Conjuntos de parámetros

-ClusterSpn

Especifica el nombre de entidad de seguridad del clúster que se va a usar para las credenciales de Windows.

Propiedades de parámetro

Conjuntos de parámetros

-ConnectionEndpoint

Especifica una matriz de puntos de conexión para el clúster con el formato ClusterAddress: ClientConnectionEndpoint, donde ClusterAddress es la dirección IPv4, la dirección IPv6 o el nombre de dominio completo (FQDN) del nodo de clúster para conectarse a y ClientConnectionEndpoint es el puerto de conexión de cliente especificado en el manifiesto del clúster. Incluya direcciones IPv6 entre corchetes ([]). Los puntos de conexión válidos tienen el siguiente formato:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

Propiedades de parámetro

Conjuntos de parámetros

-ConnectionInitializationTimeoutInSec

Especifica el período de tiempo de espera, en segundos, para la operación.

Propiedades de parámetro

Conjuntos de parámetros

-DSTS

Este parámetro es solo para uso interno.

Propiedades de parámetro

Conjuntos de parámetros

-FindType

Especifica el tipo de findValue para buscar certificado en el almacén de certificados. Se admiten los siguientes tipos de filtro:

• FindByThumbprint. Busque el certificado por huella digital del certificado.
• FindBySubjectName. Buscar certificado en el almacén de certificados por nombre distintivo del firmante o nombre común, cuando se proporciona el nombre distintivo del firmante en FindValue, el nombre del firmante del certificado debe codificarse en la codificación ASN debido a una restricción en la API criptográfica nativa de Windows. No hay ninguna restricción de este tipo cuando se proporciona un nombre común en FindValue.
• FindBySubjectDistinguishedName
• FindByIssuerName
• FindByIssuerDistinguishedName
• FindBySerialNumber
• FindByTimeValid
• FindByTimeNotYetValid
• FindByTimeExpired
• FindByTemplateName
• FindByApplicationPolicy
• FindByCertificatePolicy
• FindByExtension
• FindByKeyUsage
• FindBySubjectKeyIdentifier

Propiedades de parámetro

Conjuntos de parámetros

-FindValue

Especifica el valor de filtro para buscar un certificado en el almacén de certificados.

Propiedades de parámetro

Conjuntos de parámetros

-GetMetadata

Al conectarse con AzureActiveDirectory, recupera de forma anónima los metadatos usados para la adquisición de tokens y no intenta ninguna autenticación.

Propiedades de parámetro

Conjuntos de parámetros

-HealthOperationTimeoutInSec

Especifica el período de tiempo de espera, en segundos, para enviar informes de mantenimiento. Cuando una operación de mantenimiento agota el tiempo de espera o produce un error de comunicación, el cliente de mantenimiento reintenta internamente la operación.

Propiedades de parámetro

Conjuntos de parámetros

-HealthReportRetrySendIntervalInSec

Especifica el intervalo, en segundos, en el que el cliente de mantenimiento vuelve a intentar enviar los informes que no se pudieron enviar o conservar en el almacén de estado. El valor mínimo admitido es de 1 segundo.

Propiedades de parámetro

Conjuntos de parámetros

-HealthReportSendIntervalInSec

Especifica el intervalo, en segundos, en el que el cliente de mantenimiento envía los informes de mantenimiento al almacén de estado. Si se establece en 0, el cliente de mantenimiento enviará los informes inmediatamente.

Propiedades de parámetro

Conjuntos de parámetros

-Interactive

Indica si el cmdlet funciona de forma interactiva.

Propiedades de parámetro

Conjuntos de parámetros

-KeepAliveIntervalInSec

Especifica el período de conexión keep-alive en segundos. Este intervalo impide que una conexión finalice debido a la inactividad durante las operaciones que se ejecutan de forma asincrónica.

Propiedades de parámetro

Conjuntos de parámetros

-MetaDataEndpoint

Este parámetro es solo para uso interno.

Propiedades de parámetro

Conjuntos de parámetros

-PartitionLocationCacheLimit

Especifica el número de particiones almacenadas en caché para la resolución del servicio. El valor predeterminado es 0, lo que significa que no hay límite.

Propiedades de parámetro

Conjuntos de parámetros

-SecurityToken

Al conectarse con AzureActiveDirectory, el token de seguridad especificado se usa directamente para la autenticación y autorización en lugar de realizar el inicio de sesión de usuario interactivo.

Propiedades de parámetro

Conjuntos de parámetros

-ServerCertThumbprint

Especifica una matriz de las huellas digitales esperadas para el lado del clúster. Estas huellas digitales se usan para autenticar que el cmdlet se conecta al punto de conexión del clúster correcto durante la autenticación mutua de x509 o Azure Active Directory.

Propiedades de parámetro

Conjuntos de parámetros

-ServerCommonName

Especifica una matriz de los nombres comunes esperados para el lado del clúster. Estos nombres se usan para autenticar que el cmdlet se conecta al punto de conexión del clúster correcto durante la autenticación mutua de x509 o Azure Active Directory.

Propiedades de parámetro

Conjuntos de parámetros

-ServiceChangePollIntervalInSec

Especifica el intervalo, en segundos, en el que el cliente de fabric sondea los cambios del servicio. Este intervalo lo usa el modelo antiguo de notificaciones de cambio de direcciones de servicio basadas en sondeo.

Propiedades de parámetro

Conjuntos de parámetros

-SkipChecks

Indica que se omiten las comprobaciones de validación de capacidad de respuesta del servicio del sistema al conectarse al clúster.

Propiedades de parámetro

Conjuntos de parámetros

-StoreLocation

Especifica la ubicación del almacén de un certificado. Los valores aceptables para este parámetro son:

• CurrentUser
• LocalMachine

Propiedades de parámetro

Conjuntos de parámetros

-StoreName

Especifica el nombre del almacén de certificados para cargar el certificado de cliente.

Propiedades de parámetro

Conjuntos de parámetros

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

Propiedades de parámetro

Conjuntos de parámetros

-WindowsCredential

Indica que el cmdlet usa credenciales de Windows para conectarse a un clúster de Service Fabric.

Propiedades de parámetro

Conjuntos de parámetros

-X509Credential

Indica que el cmdlet usa un certificado x509 para realizar la autenticación mutua con un clúster de Service Fabric.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

None

Salidas

System.Object

Vínculos relacionados

• Get-ServiceFabricClusterConnection
• Test-ServiceFabricClusterConnection