Add-SqlFirewallRule
Добавляет правило брандмауэра Windows для разрешения подключений к конкретному экземпляру SQL Server.
Синтаксис
ByPath (по умолчанию)
Add-SqlFirewallRule
[-Credential] <PSCredential>
[-Path <String[]>]
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Add-SqlFirewallRule
[-Credential] <PSCredential>
-InputObject <Server[]>
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Add-SqlFirewallRule
[-Credential] <PSCredential>
-ServerInstance <String[]>
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Add-SqlFirewallRule добавляет правило брандмауэра Windows для разрешения подключений к указанному экземпляру SQL Server. Облачный адаптер SQL Server должен быть запущен и доступен на компьютере, на котором размещен экземпляр SQL Server.
Этот командлет поддерживает следующие режимы работы:
- Укажите путь к экземпляру Windows PowerShell.
- Укажите объект сервера.
- Укажите экземпляр сервера целевого экземпляра SQL Server.
Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.
Примеры
Пример 1. Добавление правила брандмауэра Windows на локальном компьютере
PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate
Первая команда изменяет каталог экземпляра компьютера SQL Server.
Пример 2. Добавление правила брандмауэра Windows на локальный компьютер через канал
PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer001" | Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate
Эта команда получает экземпляр SQL Server на основе учетных данных, хранящихся в переменной с именем $Credentials. Затем команда передает экземпляры SQL Server SQL Server на компьютере с именем Computer001. Затем команда добавляет правила брандмауэра Windows, чтобы разрешить подключения для каждого экземпляра. Самозаверяющий сертификат целевого компьютера автоматически принимается без запроса пользователя.
Параметры
-AutomaticallyAcceptUntrustedCertificates
Указывает, что этот командлет автоматически принимает ненадежные сертификаты.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета. Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает объект PSCredential для подключения к SQL Server. Чтобы получить объект учетных данных, используйте командлет Get-Credential. Для получения дополнительных сведений введите Get-Help Get-Credential.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает серверный объект целевого экземпляра SQL Server.
Свойства параметра
| Тип: | Server[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByObject
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ManagementPublicPort
Указывает порт общедоступного управления на целевом компьютере. Этот параметр используется, если порты целевого компьютера не доступны напрямую, но предоставляются через конечные точки, что означает, что они должны быть подключены к другому порту.
Облачный адаптер SQL Server должен быть доступен этим портом.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Path
Указывает путь к экземпляру SQL Server, на котором выполняется операция. Если этот параметр не указан, значение этого параметра по умолчанию соответствует текущему рабочему расположению.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByPath
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetryTimeout
Указывает период времени для повтора команды на целевом сервере. После истечения времени ожидания попытка повтора не выполняется.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ServerInstance
Указывает имя экземпляра SQL Server в виде массива, который становится целью операции.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ByName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | 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.
Входные данные
Microsoft.SqlServer.Management.Smo.Server
System.String[]