Connect-ServiceFabricCluster

Módulo:

ServiceFabric

Crea una conexión a un clúster de 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

El cmdlet Connect-ServiceFabricCluster crea una conexión a un clúster de Service Fabric independiente que permite ejecutar acciones de administración para ese clúster. Después de conectarse a un clúster, puede ver la configuración de la conexión mediante el cmdlet Get-ServiceFabricClusterConnection .

Para administrar clústeres de Service Fabric, inicie Windows PowerShell mediante la opción Ejecutar como administrador.

Ejemplos

Ejemplo 1: Conexión a un clúster

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

Este comando crea una conexión al clúster especificado.

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

Este comando se conecta a un clúster mediante un certificado X.509. Este comando usa la característica de expansión de Windows PowerShell para crear una tabla hash para los parámetros y, a continuación, las proporciona al cmdlet Connect-ServiceFabricCluster.

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

Nota: La conexión a un clúster administrado requiere módulos de PowerShell "Az.ServiceFabric" y "Az.Resources" para consultar las huellas digitales del certificado de servidor.

Este comando consulta primero el recurso de clúster administrado para las huellas digitales del certificado de servidor actual y, a continuación, se conecta al clúster mediante el certificado X509. Proporcione el nombre del grupo de recursos para que el clúster administrado recupere información de conexión, incluido el identificador de recurso completo del clúster administrado. Consulte Conexión a un clúster administrado de Service Fabric.

A continuación, este comando se conecta a un clúster mediante un certificado X.509.

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

Este comando se conecta a un clúster mediante la autenticación de Azure Active Directory (AAD). Este comando usa la característica de expansión de Windows PowerShell para crear una tabla hash para los parámetros y, a continuación, las proporciona al cmdlet Connect-ServiceFabricCluster.

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

Este comando usa la característica de expansión de Windows PowerShell para crear una tabla hash para los parámetros y, a continuación, las proporciona al cmdlet Connect-ServiceFabricCluster.

Ejemplo 6: Conexión a un clúster protegido con cuentas de equipo

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

Este comando se conecta a un clúster protegido con cuentas de equipo.

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

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

Este comando crea una conexión al clúster especificado.

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.

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

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

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

-AzureActiveDirectory

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

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

-CloudServiceDNSNames

Este parámetro es solo para uso interno.

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

-CloudServiceName

Este parámetro es solo para uso interno.

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

-ClusterSpn

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

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

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

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

-ConnectionInitializationTimeoutInSec

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

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

-DSTS

Este parámetro es solo para uso interno.

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

-FindType

Especifica el tipo de FindValue para buscar el 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 se debe codificar 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 el nombre común en FindValue.
• 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

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

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

-GetMetadata

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

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

-HealthOperationTimeoutInSec

Especifica el período de tiempo de espera, en segundos, para enviar informes de estado. 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.

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

-HealthReportRetrySendIntervalInSec

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

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

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

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

-Interactive

Indica si el cmdlet funciona de forma interactiva.

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

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

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

-MetaDataEndpoint

Este parámetro es solo para uso interno.

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

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

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

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

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

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

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

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

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

-ServiceChangePollIntervalInSec

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

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

-SkipChecks

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

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

-StoreLocation

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

• CurrentUser
• LocalMachine

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

-StoreName

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

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

-TimeoutSec

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

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

-WindowsCredential

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

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

-X509Credential

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

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

Entradas

None

Salidas

System.Object

Vínculos relacionados

• Get-ServiceFabricClusterConnection
• Test-ServiceFabricClusterConnection