Set-SqlAvailabilityReplica
Establece la configuración en una réplica de disponibilidad.
Sintaxis
ByPath (Es el valor predeterminado).
Set-SqlAvailabilityReplica
[[-Path] <String>]
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Set-SqlAvailabilityReplica
[-InputObject] <AvailabilityReplica>
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-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 provocar 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. Las conexiones que tienen con la cadena de conexión de la propiedad ReadOnly 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 aceptables para este parámetro son:
- SynchronousCommit
- AsincrónicoCommit
Puede especificar un valor de $Null.
Propiedades del parámetro
| Tipo: | AvailabilityReplicaAvailabilityMode |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ConnectionModeInPrimaryRole
Especifica cómo controla la réplica de disponibilidad las conexiones cuando se encuentra en el rol principal. Los valores aceptables para este parámetro son:
- AllowReadWriteConnections. Permitir conexiones de lectura y escritura.
- AllowAllConnections. Permitir todas las conexiones.
Propiedades del parámetro
| Tipo: | AvailabilityReplicaConnectionModeInPrimaryRole |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ConnectionModeInSecondaryRole
Especifica cómo controla la réplica de disponibilidad las conexiones cuando se encuentra en el rol secundario. Los valores aceptables para este parámetro son:
- AllowNoConnections. No permitir conexiones.
- AllowReadIntentConnectionsOnly. Permitir solo conexiones de intención de lectura.
- AllowAllConnections. Permitir todas las conexiones.
Propiedades del parámetro
| Tipo: | AvailabilityReplicaConnectionModeInSecondaryRole |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 con el formato siguiente:
TCP://system-address:port
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-FailoverMode
Especifica el modo de conmutación por error. Los valores aceptables para este parámetro son:
- Automático
- Manual. Puede especificar un valor de $Null.
Propiedades del parámetro
| Tipo: | AvailabilityReplicaFailoverMode |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-InputObject
Especifica el grupo de disponibilidad, como un objeto AvailabilityGroup , al que pertenece la réplica.
Propiedades del parámetro
| Tipo: | AvailabilityReplica |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByObject
| Posición: | 2 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ByPath
| Posición: | 2 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReadonlyRoutingConnectionUrl
Especifica el nombre de dominio completo (FQDN) y el puerto que se usarán al enrutar a la réplica para conexiones de solo lectura, como en el ejemplo siguiente:
TCP://DBSERVER8.manufacturing.Contoso.com:7024
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReadOnlyRoutingList
Especifica una lista ordenada de nombres de servidor de réplica que representan la secuencia de sondeo para que el director de conexión use 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.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Script
Indica que este cmdlet devuelve un script de Transact-SQL que realiza la tarea que realiza este cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.