Add-SqlFirewallRule

Модуль:

SQLServer

Добавляет правило брандмауэра Windows, чтобы разрешить подключения к определенному экземпляру SQL Server.

Синтаксис

Add-SqlFirewallRule
   [-Path <String[]>]
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-SqlFirewallRule
   -InputObject <Server[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-SqlFirewallRule
   -ServerInstance <String[]>
   [-Credential] <PSCredential>
   [-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
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед выполнением командлета. Запрашивает подтверждение перед выполнением командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Указывает объект PSCredential для подключения к SQL Server. Чтобы получить объект учетных данных, используйте командлет Get-Credential. Для получения дополнительных сведений введите Get-Help Get-Credential.

Тип:	PSCredential
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Указывает серверный объект целевого экземпляра SQL Server.

Тип:	Server[]
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ManagementPublicPort

Указывает порт общедоступного управления на целевом компьютере. Этот параметр используется, если порты целевого компьютера недоступны напрямую, но предоставляются через конечные точки, что означает, что они должны быть подключены к другому порту.

SQL Server облачный адаптер должен быть доступен через этот порт.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Path

Указывает путь к экземпляру SQL Server, в котором этот командлет выполняет операцию. Если этот параметр не указан, значение этого параметра по умолчанию соответствует текущему рабочему расположению.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RetryTimeout

Указывает период времени для повтора команды на целевом сервере. По истечении времени ожидания попытка повтора не выполняется.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ServerInstance

Указывает имя экземпляра SQL Server в виде массива, который становится целевым объектом операции.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется. Показывает, что произойдет при выполнении командлета. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Выходные данные

System.Object

Связанные ссылки

• Remove-SqlFirewallRule