New-SqlAvailabilityGroup
Создает группу доступности.
Синтаксис
New-SqlAvailabilityGroup
-AvailabilityReplica <AvailabilityReplica[]>
[-Database <String[]>]
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-BasicAvailabilityGroup]
[-DatabaseHealthTrigger]
[-DtcSupportEnabled]
[-Name] <String>
[[-Path] <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-SqlAvailabilityGroup
-AvailabilityReplica <AvailabilityReplica[]>
[-Database <String[]>]
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-BasicAvailabilityGroup]
[-DatabaseHealthTrigger]
[-DtcSupportEnabled]
[-Name] <String>
[-InputObject] <Server>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Командлет New-SqlAvailabilityGroup создает группу доступности в группе доступности AlwaysOn. Параметр InputObject или Path указывает сервер, на котором размещается начальная основная реплика.
Примеры
Пример 1. Создание группы доступности
PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version)
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")Первая команда получает экземпляр SQL Server на сервере-источнике, а затем сохраняет его в переменной $PrimaryServer.
Вторая команда получает экземпляр SQL Server на сервере-получателе, а затем сохраняет его в переменной $SecondaryServer.
Третья команда создает реплика, включающую экземпляр сервера-источника, с помощью командлета New-SqlAvailabilityReplica, а затем сохраняет его в переменной $PrimaryReplica. Команда задает версию экземпляра сервера с помощью свойства Version $PrimaryServer.
Четвертая команда создает реплика, включающую экземпляр сервера-получателя, с помощью New-SqlAvailabilityReplica, а затем сохраняет его в переменной $SecondaryReplica. Команда задает версию экземпляра сервера с помощью свойства Version объекта $SecondaryServer.
Последняя команда создает группу доступности. В нем указывается имя, основной сервер, реплики и другие сведения.
Параметры
-AutomatedBackupPreference
Задает предпочтительный параметр автоматического резервного копирования для группы доступности. Допустимые значения для этого параметра:
- Первичная. указывает, что резервное копирование всегда выполняется на первичной реплике. Этот параметр поддерживает использование функций, недоступных при выполнении резервного копирования на дополнительном реплика, например разностном резервном копировании.
- SecondaryOnly. указывает, что резервное копирование никогда не выполняется на первичной реплике. Если основной реплика является единственным реплика в сети, резервное копирование не выполняется.
- Вторичного. Указывает, что резервное копирование выполняется на вторичных репликах, если только основная реплика не является единственной реплика в сети. После этого резервное копирование производится на первичной реплике.
- Нет. Указывает, что основное или дополнительное состояние не учитывается при принятии решения о том, какой реплика выполняет резервное копирование. Вместо этого приоритет резервного копирования и состояние в сети определяют, какой реплика выполняет резервное копирование.
| Тип: | AvailabilityGroupAutomatedBackupPreference |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AvailabilityReplica
Указывает массив реплик доступности, который этот командлет включает в группу доступности. Чтобы получить объект AvailabilityReplica , используйте командлет New-SqlAvailabilityReplica . Укажите параметр AsTemplate .
| Тип: | AvailabilityReplica[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-BasicAvailabilityGroup
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Database
Задает массив локальных пользовательских баз данных для чтения и записи. Эти базы данных должны использовать модель полного восстановления и не должны использовать AUTO_CLOSE. Эти базы данных принадлежат другой группе доступности и не могут быть настроены для зеркального отображения. Необходимо указать значение для этого параметра.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DatabaseHealthTrigger
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DtcSupportEnabled
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-FailureConditionLevel
Указывает поведение автоматической отработки отказа группы доступности. Допустимые значения для этого параметра:
- OnServerDown. Отработка отказа или перезапуск при остановке службы SQL Server.
- OnServerUnresponsive. Отработка отказа или перезапуск при выполнении какого-либо условия с меньшим значением, а также при подключении службы SQL Server к кластеру и превышении порогового значения HealthCheckTimeout или если реплика доступности, в настоящее время в основной роли, находится в состоянии сбоя.
- OnCriticalServerError. Отработка отказа или перезапуск при выполнении любого условия с меньшим значением, а также при возникновении внутренней критической ошибки сервера, которая включает нехватку памяти, серьезное нарушение доступа к записи или слишком большой объем дампа.
- OnModerateServerError. Отработка отказа или перезапуск при выполнении какого-либо условия с меньшим значением, а также при возникновении умеренной ошибки сервера, которая включает постоянное отсутствие памяти.
- OnAnyQualifiedFailureConditions. Отработка отказа или перезапуск при выполнении какого-либо условия с меньшим значением, а также при возникновении соответствующего условия сбоя, которое включает в себя исчерпание рабочего потока подсистемы и неустранимую взаимоблокировку.
| Тип: | AvailabilityGroupFailureConditionLevel |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-HealthCheckTimeout
Указывает период времени (в миллисекундах), по истечении которого группы доступности AlwaysOn объявляют неработоспособный сервер, не отвечающий на запросы.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Указывает экземпляр SQL Server, на котором размещается основная реплика группы доступности, создаваемой этим командлетом.
| Тип: | Server |
| Position: | 3 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Name
Указывает имя группы доступности, создаваемой этим командлетом.
| Тип: | String |
| Position: | 2 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Path
Указывает путь к экземпляру SQL Server, на котором размещается начальная основная реплика группы доступности, создаваемой этим командлетом. Если этот параметр не указан, этот командлет использует текущее рабочее расположение. Если указать значение, путь должен существовать в данный момент.
| Тип: | String |
| Position: | 3 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Script
Указывает, что этот командлет возвращает скрипт Transact-SQL, который выполняет задачу, выполняемую этим командлетом.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.SqlServer.Management.Smo.Server
Вы можете передать экземпляр сервера в этот командлет.
Выходные данные
Microsoft.SqlServer.Management.Smo.AvailabilityGroup
Этот командлет возвращает группу доступности.