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.
| Type: | AvailabilityReplicaAvailabilityMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupPriority
Указывает требуемый приоритет реплик при выполнении резервного копирования. Допустимые значения для этого параметра: целые числа от 0 до 100. Из набора реплик, которые находятся в сети и доступны, резервное копирование выполняет реплика с наивысшим приоритетом.
Значение нуля (0) указывает, что реплика не является кандидатом.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionModeInPrimaryRole
Указывает, как реплика доступности обрабатывает подключения в основной роли. Допустимые значения для этого параметра:
- AllowReadWriteConnections. Разрешить подключения для чтения и записи.
- AllowAllConnections. Разрешить все подключения.
| Type: | AvailabilityReplicaConnectionModeInPrimaryRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionModeInSecondaryRole
Указывает, как реплика доступности обрабатывает подключения во вторичной роли. Допустимые значения для этого параметра:
- AllowNoConnections. Запретить подключения.
- AllowReadIntentConnectionsOnly. Разрешить только подключения с намерением чтения.
- AllowAllConnections. Разрешить все подключения.
| Type: | AvailabilityReplicaConnectionModeInSecondaryRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndpointUrl
Указывает URL-адрес конечной точки зеркального отображения базы данных. Этот URL-адрес является TCP-адресом в следующей форме:
TCP://системный адрес:порт
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailoverMode
Указывает режим отработки отказа. Допустимые значения для этого параметра:
- Автоматически
- Вручную. Можно указать значение $Null.
| Type: | AvailabilityReplicaFailoverMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Указывает группу доступности в виде объекта AvailabilityGroup, к которой принадлежит реплика.
| Type: | AvailabilityReplica |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
Указывает путь к группе доступности, к которой принадлежит реплика. Если этот параметр не указан, этот командлет использует текущее рабочее расположение.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadonlyRoutingConnectionUrl
Указывает полное доменное имя (FQDN) и порт для маршрутизации в реплика для подключений только для чтения, как показано в следующем примере:
TCP://DBSERVER8.manufacturing.Contoso.com:7024
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadOnlyRoutingList
Задает упорядоченный список имен серверов реплика, представляющих последовательность проб, которую директор подключений использует при перенаправлении подключений только для чтения через этот реплика доступности. Этот параметр применяется, если реплика доступности является текущим основным реплика группы доступности.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Script
Указывает, что этот командлет возвращает скрипт Transact-SQL, который выполняет задачу, выполняемую этим командлетом.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionTimeout
Указывает время (в секундах) ожидания ответа между основным реплика и этим реплика до сбоя подключения.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Microsoft.SqlServer.Management.Smo.AvailabilityReplica