Set-SqlAvailabilityReplica
Задает параметры для реплика доступности.
Синтаксис
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>] Описание
Командлет Set-SqlAvailabilityReplica задает или изменяет различные свойства для реплика доступности. Выполните этот командлет на экземпляре сервера, на котором размещен основной реплика.
Примеры
Пример 1. Изменение режима доступности реплика и автоматической отработки отказа
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode Automatic -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"Эта команда изменяет реплика с именем Replica02 в группе доступности MainAG для использования режима доступности синхронной фиксации и поддержки автоматической отработки отказа.
Пример 2. Изменение реплика для поддержки принудительной отработки отказа вручную
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode AsynchronousCommit -FailoverMode Manual -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"Эта команда изменяет реплика с именем Replica02 в группе доступности MainAG для использования режима доступности асинхронной фиксации и поддержки только принудительной отработки отказа вручную, что может привести к потере данных.
Пример 3. Разрешение всех подключений во вторичной роли
PS C:\> Set-SqlAvailabilityReplica -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"Эта команда изменяет реплика Replica02 в группе доступности MainAG, чтобы разрешить все подключения во вторичной роли. Это позволяет разгружать рабочие нагрузки обработки данных только для чтения во вторичные реплики.
Пример 4. Настройка основного реплика и дополнительного реплика для маршрутизации только для чтения
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Первая команда изменяет расположение на расположение в поставщике SQLSERVER: .
Вторая команда получает реплика для сервера-источника, а затем сохраняет его в переменной $PrimaryReplica.
Третья команда получает реплика для сервера-получателя, а затем сохраняет его в переменной $SecondaryReplica.
Четвертая команда назначает URL-адрес маршрутизации только для чтения основному реплика. Затем для первичной реплики задается список маршрутизации только для чтения.
Пятая команда назначает URL-адрес маршрутизации только для чтения вторичному реплика.
Шестая команда задает список маршрутизации только для чтения на основном реплика. Connections со свойством ReadOnly строка подключения перенаправляются на дополнительный реплика. Если дополнительный реплика недоступен для чтения, подключение направляется обратно в основной реплика.
Пример 5. Изменение приоритета резервного копирования
PS C:\> Set-SqlAvailabilityReplica -BackupPriority 60 -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"Эта команда устанавливает приоритет резервного копирования для реплика доступности Replica02 значение 60. Этот приоритет используется экземпляром сервера, на котором размещается основная реплика, чтобы решить, какие реплика должны обслуживать автоматический запрос на резервное копирование базы данных в группе доступности. Выбирается реплика с наивысшим приоритетом.
Параметры
-AvailabilityMode
Указывает режим доступности реплика. Допустимые значения для этого параметра:
- SynchronousCommit
- AsynchronousCommit
Можно указать значение $Null.
| Тип: | AvailabilityReplicaAvailabilityMode |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-BackupPriority
Указывает требуемый приоритет реплик при выполнении резервного копирования. Допустимые значения для этого параметра: целые числа от 0 до 100. Из набора реплик, которые находятся в сети и доступны, резервное копирование выполняет реплика с наивысшим приоритетом.
Значение нуля (0) указывает, что реплика не является кандидатом.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ConnectionModeInPrimaryRole
Указывает, как реплика доступности обрабатывает подключения в основной роли. Допустимые значения для этого параметра:
- AllowReadWriteConnections. Разрешить подключения для чтения и записи.
- AllowAllConnections. Разрешить все подключения.
| Тип: | AvailabilityReplicaConnectionModeInPrimaryRole |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ConnectionModeInSecondaryRole
Указывает, как реплика доступности обрабатывает подключения во вторичной роли. Допустимые значения для этого параметра:
- AllowNoConnections. Запретить подключения.
- AllowReadIntentConnectionsOnly. Разрешить только подключения с намерением чтения.
- AllowAllConnections. Разрешить все подключения.
| Тип: | AvailabilityReplicaConnectionModeInSecondaryRole |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EndpointUrl
Указывает URL-адрес конечной точки зеркального отображения базы данных. Этот URL-адрес является TCP-адресом в следующей форме:
TCP://системный адрес:порт
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-FailoverMode
Указывает режим отработки отказа. Допустимые значения для этого параметра:
- Автоматически
- Вручную. Можно указать значение $Null.
| Тип: | AvailabilityReplicaFailoverMode |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Указывает группу доступности в виде объекта AvailabilityGroup, к которой принадлежит реплика.
| Тип: | AvailabilityReplica |
| Position: | 2 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Path
Указывает путь к группе доступности, к которой принадлежит реплика. Если этот параметр не указан, этот командлет использует текущее рабочее расположение.
| Тип: | String |
| Position: | 2 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ReadonlyRoutingConnectionUrl
Указывает полное доменное имя (FQDN) и порт для маршрутизации в реплика для подключений только для чтения, как показано в следующем примере:
TCP://DBSERVER8.manufacturing.Contoso.com:7024
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ReadOnlyRoutingList
Задает упорядоченный список имен серверов реплика, представляющих последовательность проб, которую директор подключений использует при перенаправлении подключений только для чтения через этот реплика доступности. Этот параметр применяется, если реплика доступности является текущим основным реплика группы доступности.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Script
Указывает, что этот командлет возвращает скрипт Transact-SQL, который выполняет задачу, выполняемую этим командлетом.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SessionTimeout
Указывает время (в секундах) ожидания ответа между основным реплика и этим реплика до сбоя подключения.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.SqlServer.Management.Smo.AvailabilityReplica