Set-SqlAvailabilityReplica
Establece la configuración en una réplica de disponibilidad.
Sintaxis
Set-SqlAvailabilityReplica
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[[-Path] <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SqlAvailabilityReplica
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-InputObject] <AvailabilityReplica>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Set-SqlAvailabilityReplica establece o modifica una variedad de propiedades para una réplica de disponibilidad. Ejecute este cmdlet en la instancia del servidor que hospeda la réplica principal.
Ejemplos
Ejemplo 1: Modificación de un modo de disponibilidad de réplica y conmutación automática por error
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode Automatic -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Este comando modifica la réplica denominada Replica02 en el grupo de disponibilidad denominado MainAG para usar el modo de disponibilidad de confirmación sincrónica y para admitir la conmutación automática por error.
Ejemplo 2: Modificación de una réplica para admitir la conmutación por error manual forzada
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode AsynchronousCommit -FailoverMode Manual -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Este comando modifica la réplica denominada Replica02 en el grupo de disponibilidad denominado MainAG para usar el modo de disponibilidad de confirmación asincrónica y para admitir solo la conmutación por error manual forzada, lo que podría incurrir en pérdida de datos.
Ejemplo 3: Permitir todas las conexiones en el rol secundario
PS C:\> Set-SqlAvailabilityReplica -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Este comando modifica la réplica "Replica02" en el grupo de disponibilidad MainAG para permitir todas las conexiones del rol secundario. Esto le permite descargar cargas de trabajo de procesamiento de datos de solo lectura en réplicas secundarias.
Ejemplo 4: Configuración de una réplica principal y una réplica secundaria para el enrutamiento de solo lectura
PS C:\> Set-Location "SQLSERVER:\SQL\PrimaryServer\default\AvailabilityGroups\MainAG"
C:\PS> $PrimaryReplica = Get-Item "AvailabilityReplicas\PrimaryServer"
C:\PS> $SecondaryReplica = Get-Item "AvailabilityReplicas\SecondaryServer"
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://PrimaryServer.domain.com:5022" -InputObject $PrimaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://SecondaryServer.domain.com:5022" -InputObject $SecondaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingList "SecondaryServer","PrimaryServer" -InputObject $PrimaryReplica
El primer comando cambia la ubicación a una ubicación del proveedor SQLSERVER: .
El segundo comando obtiene la réplica del servidor principal y, a continuación, la almacena en la variable $PrimaryReplica.
El tercer comando obtiene la réplica del servidor secundario y, a continuación, la almacena en la variable $SecondaryReplica.
El cuarto comando asigna una dirección URL de enrutamiento de solo lectura a la réplica principal. Después, establece la lista de enrutamiento de solo lectura en la réplica principal.
El quinto comando asigna una dirección URL de enrutamiento de solo lectura a la réplica secundaria.
El sexto comando establece la lista de enrutamiento de solo lectura en la réplica principal. Connections que tienen con la propiedad ReadOnly cadena de conexión se redirigen a la réplica secundaria. Si la réplica secundaria no es legible, la conexión se dirige de nuevo a la réplica principal.
Ejemplo 5: Modificación de la prioridad de copia de seguridad
PS C:\> Set-SqlAvailabilityReplica -BackupPriority 60 -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Este comando establece la prioridad de copia de seguridad de la réplica de disponibilidad "Replica02" en 60. Esta prioridad la usa la instancia del servidor que hospeda la réplica principal para decidir qué réplica debe atender una solicitud de copia de seguridad automatizada en una base de datos del grupo de disponibilidad. Se elige la réplica que tiene la prioridad más alta.
Parámetros
-AvailabilityMode
Especifica el modo de disponibilidad de réplica. Los valores permitidos para este parámetro son los siguientes:
- SynchronousCommit
- AsincrónicoCommit
Puede especificar un valor de $Null.
Tipo: | AvailabilityReplicaAvailabilityMode |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-BackupPriority
Especifica la prioridad deseada de las réplicas en la realización de copias de seguridad. Los valores aceptables para este parámetro son: enteros de 0 a 100. Del conjunto de réplicas que están en línea y disponibles, la réplica que tiene la prioridad más alta realiza la copia de seguridad.
Un valor de cero (0) indica que la réplica no es candidata.
Tipo: | Int32 |
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 |
-ConnectionModeInPrimaryRole
Especifica cómo la réplica de disponibilidad controla las conexiones cuando se encuentra en el rol principal. Los valores permitidos para este parámetro son los siguientes:
- AllowReadWriteConnections. Permitir conexiones de lectura y escritura.
- AllowAllConnections. Permitir todas las conexiones.
Tipo: | AvailabilityReplicaConnectionModeInPrimaryRole |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ConnectionModeInSecondaryRole
Especifica cómo controla la réplica de disponibilidad las conexiones cuando se encuentra en el rol secundario. Los valores permitidos para este parámetro son los siguientes:
- AllowNoConnections. No permitir conexiones.
- AllowReadIntentConnectionsOnly. Permitir solo conexiones de intención de lectura.
- AllowAllConnections. Permitir todas las conexiones.
Tipo: | AvailabilityReplicaConnectionModeInSecondaryRole |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EndpointUrl
Especifica la dirección URL del punto de conexión de creación de reflejo de la base de datos. Esta dirección URL es una dirección TCP de la siguiente forma:
TCP://system-address:port
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-FailoverMode
Especifica el modo de conmutación por error. Los valores permitidos para este parámetro son los siguientes:
- Automático
- Manual. Puede especificar un valor de $Null.
Tipo: | AvailabilityReplicaFailoverMode |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-InputObject
Especifica el grupo de disponibilidad, como un objeto AvailabilityGroup , al que pertenece la réplica.
Tipo: | AvailabilityReplica |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Path
Especifica la ruta de acceso del grupo de disponibilidad al que pertenece la réplica. Si no especifica este parámetro, este cmdlet 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 |
-ReadonlyRoutingConnectionUrl
Especifica el nombre de dominio completo (FQDN) y el puerto que se usará al enrutar a la réplica para conexiones de solo lectura, como en el ejemplo siguiente:
TCP://DBSERVER8.manufacturing.Contoso.com:7024
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ReadOnlyRoutingList
Especifica una lista ordenada de nombres de servidor de réplica que representan la secuencia de sondeo que el director de conexión usará al redirigir las conexiones de solo lectura a través de esta réplica de disponibilidad. Este parámetro se aplica si la réplica de disponibilidad es la réplica principal actual del grupo de disponibilidad.
Tipo: | String[] |
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 de Transact-SQL que realiza la tarea que realiza este cmdlet.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SessionTimeout
Especifica la cantidad de tiempo, en segundos, para esperar una respuesta entre la réplica principal y esta réplica antes de que se produzca un error en la conexión.
Tipo: | Int32 |
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
Microsoft.SqlServer.Management.Smo.AvailabilityReplica