Remove-SqlFirewallRule

  • Ссылка
Модуль:
SQLServer

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

Синтаксис

Remove-SqlFirewallRule
      [-Path <String[]>]
      [-Credential] <PSCredential>
      [-AutomaticallyAcceptUntrustedCertificates]
      [-ManagementPublicPort <Int32>]
      [-RetryTimeout <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SqlFirewallRule
      -InputObject <Server[]>
      [-Credential] <PSCredential>
      [-AutomaticallyAcceptUntrustedCertificates]
      [-ManagementPublicPort <Int32>]
      [-RetryTimeout <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SqlFirewallRule
      -ServerInstance <String[]>
      [-Credential] <PSCredential>
      [-AutomaticallyAcceptUntrustedCertificates]
      [-ManagementPublicPort <Int32>]
      [-RetryTimeout <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Remove-SqlFirewallRule отключает правило брандмауэра Windows, разрешающее подключения к конкретному экземпляру SQL Server.

На компьютере, где размещен экземпляр SQL Server, должен быть запущен и доступен агент SQL Server Cloud Adapter.

Данный командлет поддерживает следующие режимы работы:

  • Укажите путь Windows PowerShell экземпляра.
  • Укажите серверный объект.
  • Укажите объект ServerInstance целевого экземпляра SQL Server.

Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.

Примеры

Пример 1. Отключение правила брандмауэра Windows, которое блокирует подключения к экземпляру SQL Server

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Remove-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

Эта команда отключает правило брандмауэра Windows на компьютере, чтобы заблокировать подключения к экземпляру SQL Server на этом компьютере. Текущий рабочий каталог используется для определения экземпляра сервера, на котором должна быть произведена операция. Самозаверяющий сертификат целевого компьютера автоматически принимается без запроса пользователя.

Пример 2. Отключение правила брандмауэра Windows, которое блокирует подключения ко всем экземплярам SQL Server

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer002" | Remove-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

Эта команда получает все экземпляры SQL Server на компьютере с именем Computer002 и отключает правила брандмауэра Windows для блокировки подключений к каждому из них. Самозаверяющий сертификат целевого компьютера автоматически принимается без запроса пользователя.

Параметры

-AutomaticallyAcceptUntrustedCertificates

Указывает, что этот командлет автоматически принимает недоверенные сертификаты.

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

-Confirm

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

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

-Credential

Указывает учетную запись пользователя с учетными данными администратора Windows на целевом компьютере.

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

-InputObject

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

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

-ManagementPublicPort

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

SQL Server Cloud Adapter должен быть доступен по данному порту.

Тип: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[]