Connect-ServiceFabricCluster

Referencia

Módulo:: ServiceFabric

Crea una conexión a un clúster de Service Fabric.

Sintaxis

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 le 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: 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 máquina

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 máquina.

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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int64
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AzureActiveDirectory

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CloudServiceDNSNames

Este parámetro es solo para uso interno.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CloudServiceName

Este parámetro es solo para uso interno.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClusterSpn

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 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

Tipo:	String[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ConnectionInitializationTimeoutInSec

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

Tipo:	Double
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DSTS

Este parámetro es solo para uso interno.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-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

Tipo:	X509FindType
Valores aceptados:	FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FindValue

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

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

Tipo:	Double
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

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

Tipo:	Double
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Double
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Interactive

Indica si el cmdlet funciona de forma interactiva.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Double
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MetaDataEndpoint

Este parámetro es solo para uso interno.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int64
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

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

Tipo:	Double
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SkipChecks

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

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StoreLocation

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

CurrentUser
LocalMachine

Tipo:	StoreLocation
Valores aceptados:	CurrentUser, LocalMachine
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StoreName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TimeoutSec

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

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WindowsCredential

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-X509Credential

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

System.Object

Compartir a través de

Connect-ServiceFabricCluster

Sintaxis

Description

Ejemplos

Ejemplo 1: Conexión a un clúster

Ejemplo 2: Conexión a un clúster mediante un certificado X.509

Ejemplo 3: Conexión a un clúster administrado mediante un certificado X.509

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

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

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

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

Parámetros

-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

Entradas

Salidas

Vínculos relacionados

Recursos adicionales