Compartir a través de

New-SqlHADREndpoint

  • Referencia
Módulo:
SQLServer

Crea un punto de conexión de creación de reflejo de la base de datos en una instancia de SQL Server.

Sintaxis

New-SqlHADREndpoint
   [-Port <Int32>]
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Name] <String>
   [[-Path] <String>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-SqlHADREndpoint
   [-Port <Int32>]
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Name] <String>
   [-InputObject] <Server>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-SqlHADREndpoint crea un punto de conexión de creación de reflejo de la base de datos en una instancia de SQL Server. Este punto de conexión es necesario en cada instancia de servidor que hospeda una réplica de disponibilidad para cualquier grupo de disponibilidad. Cada instancia de servidor solo puede tener un punto de conexión de creación de reflejo de la base de datos. Si una instancia de servidor posee un punto de conexión de creación de reflejo de la base de datos, use el punto de conexión existente.

Ejemplos

Ejemplo 1: Creación de un punto de conexión de creación de reflejo de la base de datos

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint"

Este comando crea un punto de conexión de creación de reflejo de la base de datos denominado MainEndpoint en la instancia del servidor ubicada en la ruta de acceso especificada. Este punto de conexión usa el puerto predeterminado, 5022.

Ejemplo 2: Creación de un punto de conexión de creación de reflejo de la base de datos que requiere cifrado

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -Port 4022 -EncryptionAlgorithm Aes -Encryption Required

Este comando crea un punto de conexión de creación de reflejo de la base de datos denominado MainEndpoint en la instancia del servidor ubicada en la ruta de acceso especificada. Este punto de conexión escucha en el puerto 4022. El punto de conexión usa el algoritmo de AES para el cifrado y requiere que las conexiones usen cifrado.

Ejemplo 3: Creación de un punto de conexión de creación de reflejo de la base de datos cifrado con un certificado

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -AuthenticationOrder Certificate -Certificate "EncryptionCertificate"

Este comando crea un punto de conexión de creación de reflejo de la base de datos denominado MainEndpoint en la instancia del servidor ubicada en la ruta de acceso especificada. Este punto de conexión usa el certificado denominado EncryptionCertificate para autenticar las conexiones.

Ejemplo 4: Creación de un script de punto de conexión de creación de reflejo de la base de datos

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -Script

Este comando genera el script de Transact-SQL que crea un punto de conexión de creación de reflejo de la base de datos denominado MainEndpoint en la instancia del servidor ubicada en la ruta de acceso especificada. Este comando no crea realmente el punto de conexión.

Parámetros

-AccessToken

El token de acceso que se usa para autenticarse en SQL Server, como alternativa a la autenticación de usuario o contraseña de Windows.

Esto se puede usar, por ejemplo, para conectarse a SQL Azure DB y SQL Azure Managed Instance mediante un Service Principal o un Managed Identity.

El parámetro que se va a usar puede ser una cadena que representa el token o un objeto PSAccessToken tal como se devuelve mediante la ejecución de Get-AzAccessToken -ResourceUrl https://database.windows.net.

Este parámetro es nuevo en la versión 22 del módulo.

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

-AuthenticationOrder

Especifica el orden y el tipo de autenticación que usa el punto de conexión.

Si la opción especificada llama a un certificado, se debe establecer el parámetro Certificate.

Tipo:EndpointAuthenticationOrder
Valores aceptados:Ntlm, Kerberos, Negotiate, Certificate, NtlmCertificate, KerberosCertificate, NegotiateCertificate, CertificateNtlm, CertificateKerberos, CertificateNegotiate
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Certificate

Especifica el nombre del certificado que usará el punto de conexión para autenticar las conexiones. El extremo lejano debe tener un certificado con la clave pública que coincida con la clave privada del certificado.

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

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

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

-Encrypt

Tipo de cifrado que se va a usar al conectarse a SQL Server.

Este valor se asigna a la propiedad EncryptSqlConnectionEncryptOption en el objeto SqlConnection del controlador Microsoft.Data.SqlClient.

En la versión 22 del módulo, el valor predeterminado es Optional (por compatibilidad con v21). En la versión 23+ del módulo, el valor predeterminado será "Obligatorio", que puede crear un cambio importante para los scripts existentes.

Este parámetro es nuevo en la versión 22 del módulo.

Tipo:String
Valores aceptados:Mandatory, Optional, Strict
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Encryption

Especifica la opción de cifrado para el punto de conexión.

El valor predeterminado es Required.

Tipo:EndpointEncryption
Valores aceptados:Disabled, Supported, Required
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EncryptionAlgorithm

Especifica la forma de cifrado que usa el punto de conexión.

De forma predeterminada, el punto de conexión usará el cifrado Aes.

NOTA: El algoritmo RC4 solo se admite para la compatibilidad con versiones anteriores. El nuevo material solo se puede cifrar mediante RC4 o RC4_128 cuando la base de datos está en el nivel de compatibilidad 90 o 100, pero no se recomienda. Para aumentar la seguridad, use un algoritmo más reciente, como uno de los algoritmos de AES en su lugar.

Tipo:EndpointEncryptionAlgorithm
Valores aceptados:None, RC4, Aes, AesRC4, RC4Aes
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HostNameInCertificate

Nombre de host que se va a usar para validar el certificado TLS/SSL de SQL Server. Debe pasar este parámetro si la instancia de SQL Server está habilitada para Forzar cifrado y desea conectarse a una instancia mediante el nombre de host o el nombre corto. Si se omite este parámetro, es necesario pasar el nombre de dominio completo (FQDN) a -ServerInstance es necesario para conectarse a una instancia de SQL Server habilitada para Forzar cifrado.

Este parámetro es nuevo en la versión 22 del módulo.

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

-InputObject

Especifica el objeto de servidor de la instancia de SQL Server donde se crea el punto de conexión.

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

-IpAddress

Especifica la dirección IP del punto de conexión. El valor predeterminado es ALL, que indica que el agente de escucha acepta una conexión en cualquier dirección IP válida.

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

-Name

Especifica el nombre del punto de conexión.

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

-Owner

Especifica el inicio de sesión del propietario del punto de conexión. De forma predeterminada, este es el inicio de sesión actual.

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

-Path

Especifica la ruta de acceso a la instancia de SQL Server del punto de conexión. Si no se especifica, se usa la ubicación de trabajo actual.

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

-Port

Especifica el puerto TCP en el que el punto de conexión escuchará las conexiones. El valor predeterminado es 5022.

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

-ProgressAction

Determina cómo Responde PowerShell a las actualizaciones de progreso generadas por un script, cmdlet o proveedor, como las barras de progreso generadas por el cmdlet Write-Progress. El cmdlet Write-Progress crea barras de progreso que muestran el estado de un comando.

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

-Script

Indica que este cmdlet devuelve un script Transact-SQL que realiza la tarea.

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

-TrustServerCertificate

Indica si el canal se cifrará mientras se pasa la cadena de certificados para validar la confianza.

En la versión 22 del módulo, el valor predeterminado es $true (por compatibilidad con v21). En la versión 23+ del módulo, el valor predeterminado será "$false", que puede crear un cambio importante para los scripts existentes.

Este parámetro es nuevo en la versión 22 del módulo.

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

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

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

Entradas

Microsoft.SqlServer.Management.Smo.Server

Salidas

SMO.Endpoint