Compartir a través de

New-SqlHADREndpoint

  • Referencia
Módulo:
SQLPS

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]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-SqlHADREndpoint
   [-Port <Int32>]
   [-Owner <String>]
   [-Certificate <String>]
   [-IpAddress <IPAddress>]
   [-AuthenticationOrder <EndpointAuthenticationOrder>]
   [-Encryption <EndpointEncryption>]
   [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
   [-Name] <String>
   [-InputObject] <Server>
   [-Script]
   [-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 extremo se requiere en cada instancia de servidor que hospede una réplica de disponibilidad de algún grupo de disponibilidad. Cada instancia de servidor solo puede tener un extremo 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 extremo 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 extremo usa el algoritmo AES para el cifrado y requiere que las conexiones usen el 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 en realidad el extremo.

Parámetros

-AuthenticationOrder

Especifica el orden y el tipo de autenticación que usa el punto de conexión. Los valores válidos son:

  • Certificado
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • Negotiate
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate.

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

Tipo:EndpointAuthenticationOrder
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 solicita su 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

-Encryption

Especifica la opción de cifrado para el punto de conexión. Los valores válidos son:

  • Disabled
  • Compatible
  • Requerido

El valor predeterminado es Required.

Tipo:EndpointEncryption
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. Los valores válidos son:

  • Aes
  • AesRC4
  • None
  • RC4
  • RC4Aes

De forma predeterminada, el extremo usará el cifrado Aes.

El algoritmo RC4 se admite únicamente por razones de 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 AES en su lugar.

Tipo:EndpointEncryptionAlgorithm
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:3
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. Este parámetro es obligatorio.

Tipo:String
Posición:2
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, se trata del 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. Este parámetro es opcional. Si no se especifica, se usa la ubicación de trabajo actual.

Tipo:String
Posición:3
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

-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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. 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

SMO.Server

Salidas

SMO.Endpoint