Add-SqlAvailabilityGroupListenerStaticIp
Добавляет статический IP-адрес в прослушиватель группы доступности.
Синтаксис
ByPath (по умолчанию)
Add-SqlAvailabilityGroupListenerStaticIp
[[-Path] <String[]>]
-StaticIp <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Add-SqlAvailabilityGroupListenerStaticIp
[-InputObject] <AvailabilityGroupListener[]>
-StaticIp <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Add-SqlAvailabilityGroupListenerStaticIp добавляет статический IP-адрес в существующую конфигурацию прослушивателя группы доступности. Можно указать адрес IPv4 и маску подсети или IPv6-адрес выполнить этот командлет на экземпляре сервера, на котором размещена первичная реплика.
Примеры
Пример 1. Добавление IPv4-адреса
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener" -StaticIp "192.169.0.1/255.255.252.0"
Эта команда добавляет статический IPv4-адрес в прослушиватель группы доступности MainListener в группу доступности с именем MainAG. Этот IPv4-адрес служит виртуальным IP-адресом прослушивателя в подсети 255.255.252.0. Если группа доступности охватывает несколько подсетей, добавьте статический IP-адрес для каждой подсети в прослушиватель. Запустите этот командлет на экземпляре сервера, на котором размещена первичная реплика.
Пример 2. Добавление IPv6-адреса
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener" -StaticIp "2001:0db8:85a3:0000:0000:8a2e:0370:7334"
Эта команда добавляет статический IPv6-адрес в прослушиватель MainListener в группе доступности MainAG.
Пример 3. Создание скрипта, который добавляет IPv4-адрес
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAg\AvailabilityGroupListeners\MainListener" -StaticIp "192.168.0.1/255.255.255.0" -Script
При этом создается скрипт Transact-SQL, который добавляет статический IPv4-адрес в прослушиватель группы доступности MainListener в группе доступности с именем MainAG.
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает прослушиватель в качестве объекта AvailabilityGroupListener , который изменяет этот командлет.
Свойства параметра
| Тип: | AvailabilityGroupListener[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByObject
| Position: | 2 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Path
Указывает путь прослушивателя группы доступности, который изменяет этот командлет. Если этот параметр не указан, этот командлет использует текущее рабочее расположение.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByPath
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Script
Указывает, что этот командлет возвращает скрипт Transact-SQL, выполняющий задачу, выполняемую этим командлетом.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-StaticIp
Задает массив адресов. Каждая запись адреса — это IPv4-адрес и маска подсети или IPv6-адрес. Прослушиватель прослушивает адреса, указанные этим параметром.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.