Set-SqlAvailabilityReplica
Define as configurações em um réplica de disponibilidade.
Sintaxe
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
O cmdlet Set-SqlAvailabilityReplica define ou modifica uma variedade de propriedades para um réplica de disponibilidade. Execute esse cmdlet na instância de servidor que hospeda o réplica primário.
Exemplos
Exemplo 1: Modificar um modo de disponibilidade réplica e failover automático
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode Automatic -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Esse comando modifica o réplica chamado Replica02 no grupo de disponibilidade chamado MainAG para usar o modo de disponibilidade de confirmação síncrona e dar suporte ao failover automático.
Exemplo 2: Modificar um réplica para dar suporte ao failover manual forçado
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode AsynchronousCommit -FailoverMode Manual -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Esse comando modifica o réplica chamado Replica02 no grupo de disponibilidade chamado MainAG para usar o modo de disponibilidade de confirmação assíncrona e para dar suporte apenas ao failover manual forçado, o que pode incorrer em perda de dados.
Exemplo 3: Permitir todas as conexões na função secundária
PS C:\> Set-SqlAvailabilityReplica -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Esse comando modifica o réplica 'Replica02' no grupo de disponibilidade MainAG para permitir todas as conexões na função secundária. Isso permite descarregar cargas de trabalho de processamento de dados somente leitura para réplicas secundárias.
Exemplo 4: configurar uma réplica primária e uma réplica secundária para roteamento somente leitura
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
O primeiro comando altera o local para um local no provedor SQLSERVER: .
O segundo comando obtém o réplica para o servidor primário e o armazena na variável $PrimaryReplica.
O terceiro comando obtém o réplica para o servidor secundário e, em seguida, armazena-o na variável $SecondaryReplica.
O quarto comando atribui uma URL de roteamento somente leitura ao réplica primário. Em seguida, ele define a lista de roteamento somente leitura na réplica primária.
O quinto comando atribui uma URL de roteamento somente leitura ao réplica secundário.
O sexto comando define a lista de roteamento somente leitura na réplica primária. Connections que têm com a propriedade ReadOnly cadeia de conexão são redirecionadas para o réplica secundário. Se o réplica secundário não for legível, a conexão será direcionada de volta para o réplica primário.
Exemplo 5: Modificar prioridade de backup
PS C:\> Set-SqlAvailabilityReplica -BackupPriority 60 -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Esse comando define a prioridade de backup do réplica de disponibilidade 'Replica02' como 60. Essa prioridade é usada pela instância de servidor que hospeda o réplica primário para decidir qual réplica deve atender a uma solicitação de backup automatizada em um banco de dados no grupo de disponibilidade. A réplica que tem a prioridade mais alta é escolhida.
Parâmetros
-AvailabilityMode
Especifica o modo de disponibilidade réplica. Os valores aceitáveis para esse parâmetro são:
- SynchronousCommit
- AsynchronousCommit
Você pode especificar um valor de $Null.
Tipo: | AvailabilityReplicaAvailabilityMode |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-BackupPriority
Especifica a prioridade desejada das réplicas na execução de backups. Os valores aceitáveis para esse parâmetro são: inteiros de 0 a 100. Do conjunto de réplicas que estão online e disponíveis, o réplica que tem a prioridade mais alta executa o backup.
Um valor zero (0) indica que o réplica não é um candidato.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ConnectionModeInPrimaryRole
Especifica como a réplica de disponibilidade lida com conexões quando na função primária. Os valores aceitáveis para esse parâmetro são:
- AllowReadWriteConnections. Permitir conexões de leitura/gravação.
- AllowAllConnections. Permitir todas as conexões.
Tipo: | AvailabilityReplicaConnectionModeInPrimaryRole |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ConnectionModeInSecondaryRole
Especifica como o réplica de disponibilidade lida com conexões quando na função secundária. Os valores aceitáveis para esse parâmetro são:
- AllowNoConnections. Não permitir conexões.
- AllowReadIntentConnectionsOnly. Permitir somente conexões de intenção de leitura.
- AllowAllConnections. Permitir todas as conexões.
Tipo: | AvailabilityReplicaConnectionModeInSecondaryRole |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EndpointUrl
Especifica a URL do ponto de extremidade de espelhamento de banco de dados. Essa URL é um endereço TCP no seguinte formato:
TCP://system-address:port
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-FailoverMode
Especifica o modo de failover. Os valores aceitáveis para esse parâmetro são:
- Automática
- Manual. Você pode especificar um valor de $Null.
Tipo: | AvailabilityReplicaFailoverMode |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InputObject
Especifica o grupo de disponibilidade, como um objeto AvailabilityGroup, ao qual o réplica pertence.
Tipo: | AvailabilityReplica |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Path
Especifica o caminho do grupo de disponibilidade ao qual o réplica pertence. Se você não especificar esse parâmetro, esse cmdlet usará o local de trabalho atual.
Tipo: | String |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ReadonlyRoutingConnectionUrl
Especifica o FQDN (nome de domínio totalmente qualificado) e a porta a serem usadas ao rotear para o réplica para conexões somente leitura, como no exemplo a seguir:
TCP://DBSERVER8.manufacturing.Contoso.com:7024
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ReadOnlyRoutingList
Especifica uma lista ordenada de nomes de servidor réplica que representam a sequência de investigação para o diretor de conexão usar ao redirecionar conexões somente leitura por meio desse réplica de disponibilidade. Esse parâmetro se aplicará se o réplica de disponibilidade for o réplica primário atual do grupo de disponibilidade.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Script
Indica que esse cmdlet retorna um script Transact-SQL que executa a tarefa que este cmdlet executa.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SessionTimeout
Especifica a quantidade de tempo, em segundos, para aguardar uma resposta entre o réplica primário e esse réplica antes que a conexão falhe.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Microsoft.SqlServer.Management.Smo.AvailabilityReplica