New-SqlAvailabilityGroupListener
Создает прослушиватель группы доступности и присоединяет его к группе доступности.
Синтаксис
New-SqlAvailabilityGroupListener
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Name] <String>
[[-Path] <String>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-SqlAvailabilityGroupListener
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет New-SqlAvailabilityGroupListener создает прослушиватель группы доступности и присоединяет его к группе доступности. Выполните этот командлет на экземпляре сервера, на котором размещена основная реплика.
Примеры
Пример 1. Создание прослушивателя для группы доступности
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"
Эта команда создает прослушиватель группы доступности с именем MainListener для группы доступности MainAG. Этот прослушиватель получает виртуальный IP-адрес с помощью DHCP. Выполните эту команду на экземпляре сервера, на котором размещен основной реплика.
Пример 2. Создание прослушивателя для группы доступности с портом, не по умолчанию
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Port 1434
Эта команда создает прослушиватель группы доступности с именем MainListener для группы доступности MainAG. Как и в предыдущем примере, этот прослушиватель получает виртуальный IP-адрес с помощью DHCP. В этом примере назначается порт 1434, на котором выполняется прослушивание.
Пример 3. Создание прослушивателя для группы доступности, которая использует DHCP
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -DhcpSubnet "192.169.0.1/255.255.252.0" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"
Эта команда создает прослушиватель группы доступности с именем MainListener для группы доступности MainAG. Этот прослушиватель получает виртуальный IP-адрес в указанной подсети с помощью DHCP.
Пример 4. Создание прослушивателя для группы доступности, которая использует статический адрес
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -StaticIp "192.168.3.1/255.255.252.0" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG"
Эта команда создает прослушиватель группы доступности с именем MainListener для группы доступности MainAG. Этот прослушиватель использует IPv4-адрес, указанный параметром StaticIp, в качестве своего виртуального IP-адреса.
Пример 5. Создание скрипта, который создает прослушиватель
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG" -Script
Эта команда создает скрипт Transact-SQL, который создает прослушиватель группы доступности с именем MainListener для группы доступности MainAG. Команда не создает прослушиватель.
Параметры
-AccessToken
Маркер доступа, используемый для проверки подлинности для SQL Server, в качестве альтернативы проверке подлинности пользователя или пароля или проверки подлинности Windows.
Его можно использовать, например, для подключения к SQL Azure DB
и SQL Azure Managed Instance
с помощью Service Principal
или Managed Identity
.
Используемый параметр может быть либо строкой, представляющей маркер, либо объектом, PSAccessToken
возвращаемым при выполнении команды Get-AzAccessToken -ResourceUrl https://database.windows.net
.
Этот параметр является новым в версии 22 модуля.
Type: | PSObject |
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 |
-DhcpSubnet
Указывает IPv4-адрес и маску подсети сети. Прослушиватель определяет адрес в этой сети с помощью DHCP. Укажите адрес в следующем формате: 192.168.0.1/255.255.255.0.
Если вы укажете этот параметр, не указывайте параметр StaticIp .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encrypt
Тип шифрования, используемый при подключении к SQL Server.
Это значение сопоставляется со свойством Encrypt
SqlConnectionEncryptOption
объекта SqlConnection драйвера Microsoft.Data.SqlClient.
В модуле версии 22 значение по умолчанию — Optional
(для совместимости с версией 21). В версии 23 и более поздних версий модуля значением по умолчанию будет "Обязательно", что может привести к критическому изменению для существующих скриптов.
Этот параметр является новым в версии 22 модуля.
Type: | String |
Accepted values: | Mandatory, Optional, Strict |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostNameInCertificate
Имя узла используется для проверки TLS/SSL-сертификата SQL Server. Этот параметр необходимо передать, если экземпляр SQL Server включен для принудительного шифрования и вы хотите подключиться к экземпляру с помощью имени узла или shortname. Если этот параметр опущен, необходимо передать полное доменное имя (FQDN) в -ServerInstance для подключения к экземпляру SQL Server, включенного для принудительного шифрования.
Этот параметр является новым в версии 22 модуля.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Указывает группу доступности в виде объекта AvailabilityGroup , к которому этот командлет присоединяет прослушиватель.
Type: | AvailabilityGroup |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Указывает имя прослушивателя.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Указывает путь к группе доступности, к которой этот командлет подключает прослушиватель. Если этот параметр не указан, этот командлет использует текущее рабочее расположение.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Указывает порт, на котором прослушиватель прослушивает подключения. По умолчанию используется порт TCP с номером 1433.
Type: | Int32 |
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 |
-StaticIp
Задает массив адресов. Каждая запись адреса является IPv4-адресом и маской подсети или IPv6-адресом. Прослушиватель прослушивает адреса, указанные этим параметром.
Если вы укажете этот параметр, не указывайте параметр DhcpSubnet .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustServerCertificate
Указывает, будет ли канал зашифрован при обходе цепочки сертификатов для проверки доверия.
В модуле версии 22 значение по умолчанию — $true
(для совместимости с версией 21). В модуле версии 23+ значение по умолчанию будет "$false", что может привести к критическому изменению для существующих скриптов.
Этот параметр является новым в версии 22 модуля.
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.AvailabilityGroup