New-SqlHADREndpoint
Crea un punto de conexión de creación de reflejo de la base de datos en una instancia de SQL Server.
Syntax
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 .
Type: | EndpointAuthenticationOrder |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | EndpointEncryption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | EndpointEncryptionAlgorithm |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica el objeto de servidor de la instancia de SQL Server donde se crea el punto de conexión.
Type: | Server |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | IPAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre del punto de conexión. Este parámetro es obligatorio.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Especifica el puerto TCP en el que el punto de conexión escuchará las conexiones. El valor predeterminado es 5022.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Script
Indica que este cmdlet devuelve un script transact-SQL que realiza la tarea.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
SMO.Server
Salidas
SMO.Endpoint