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. указывает, что резервное копирование никогда не выполняется на первичной реплике. Если основной реплика является единственным реплика в сети, резервное копирование не выполняется.
- Вторичного. Указывает, что резервное копирование выполняется на вторичных репликах, если только основная реплика не является единственной реплика в сети. После этого резервное копирование производится на первичной реплике.
- Нет. Указывает, что основное или дополнительное состояние не учитывается при принятии решения о том, какой реплика выполняет резервное копирование. Вместо этого приоритет резервного копирования и состояние в сети определяют, какой реплика выполняет резервное копирование.
| Type: | AvailabilityGroupAutomatedBackupPreference |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailabilityReplica
Указывает массив реплик доступности, который этот командлет включает в группу доступности. Чтобы получить объект AvailabilityReplica , используйте командлет New-SqlAvailabilityReplica . Укажите параметр AsTemplate .
| Type: | AvailabilityReplica[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BasicAvailabilityGroup
| Type: | SwitchParameter |
| 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 |
-Database
Задает массив локальных пользовательских баз данных для чтения и записи. Эти базы данных должны использовать модель полного восстановления и не должны использовать AUTO_CLOSE. Эти базы данных принадлежат другой группе доступности и не могут быть настроены для зеркального отображения. Необходимо указать значение для этого параметра.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatabaseHealthTrigger
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DtcSupportEnabled
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailureConditionLevel
Указывает поведение автоматической отработки отказа группы доступности. Допустимые значения для этого параметра:
- OnServerDown. Отработка отказа или перезапуск при остановке службы SQL Server.
- OnServerUnresponsive. Отработка отказа или перезапуск при выполнении какого-либо условия с меньшим значением, а также при подключении службы SQL Server к кластеру и превышении порогового значения HealthCheckTimeout или если реплика доступности, в настоящее время в основной роли, находится в состоянии сбоя.
- OnCriticalServerError. Отработка отказа или перезапуск при выполнении любого условия с меньшим значением, а также при возникновении внутренней критической ошибки сервера, которая включает нехватку памяти, серьезное нарушение доступа к записи или слишком большой объем дампа.
- OnModerateServerError. Отработка отказа или перезапуск при выполнении какого-либо условия с меньшим значением, а также при возникновении умеренной ошибки сервера, которая включает постоянное отсутствие памяти.
- OnAnyQualifiedFailureConditions. Отработка отказа или перезапуск при выполнении какого-либо условия с меньшим значением, а также при возникновении соответствующего условия сбоя, которое включает в себя исчерпание рабочего потока подсистемы и неустранимую взаимоблокировку.
| Type: | AvailabilityGroupFailureConditionLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckTimeout
Указывает период времени (в миллисекундах), по истечении которого группы доступности AlwaysOn объявляют неработоспособный сервер, не отвечающий на запросы.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Указывает экземпляр SQL Server, на котором размещается основная реплика группы доступности, создаваемой этим командлетом.
| Type: | Server |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Указывает имя группы доступности, создаваемой этим командлетом.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Указывает путь к экземпляру SQL Server, на котором размещается начальная основная реплика группы доступности, создаваемой этим командлетом. Если этот параметр не указан, этот командлет использует текущее рабочее расположение. Если указать значение, путь должен существовать в данный момент.
| Type: | String |
| Position: | 3 |
| 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 |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Microsoft.SqlServer.Management.Smo.Server
Вы можете передать экземпляр сервера в этот командлет.
Выходные данные
Microsoft.SqlServer.Management.Smo.AvailabilityGroup
Этот командлет возвращает группу доступности.