Add-SqlFirewallRule

Добавляет правило брандмауэра 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

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

Type:SwitchParameter
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

-Credential

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

Type:PSCredential
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:Server[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementPublicPort

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

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RetryTimeout

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerInstance

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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.Server[]

System.String[]

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

System.Object