Поделиться через

Set-SqlNetworkConfiguration

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

Задает конфигурацию сети целевого экземпляра SQL Server.

Синтаксис

Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   [-Path <String[]>]
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   -InputObject <Server[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   -ServerInstance <String[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-SqlNetworkConfiguration задает конфигурацию сети целевого экземпляра 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. Настройка конфигурации сети целевого SQL Server

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Set-SqlNetworkConfiguration -Credential $credential -Protocol TCP -Port 1433 -NoServiceRestart -AcceptSelfSignedCertificate

Первая команда изменяет каталог на SQLSERVER:\SQL\Computer\Instance. Вторая команда задает конфигурацию сети для приема TCP подключений через порт 1433 для именованного Computer\Instanceэкземпляра сервера. Текущий рабочий каталог используется для определения экземпляра сервера, в котором происходит операция. Служба SQL Server не перезапускается автоматически. Самозаверяющий сертификат целевого компьютера автоматически принимается без запроса пользователя.

Пример 2. Настройка конфигурации сети целевого SQL Server с помощью конвейера

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer006" | Set-SqlNetworkConfiguration -Credential $Credential -Protocol TCP -Disable -NoServiceRestart -AcceptSelfSignedCertificate;

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

Параметры

-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

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

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

-Disable

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

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

-ForceServiceRestart

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

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

-InputObject

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

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

-ManagementPublicPort

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

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

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

-NoServiceRestart

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

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

-Port

Указывает порт для приема TCP-подключений. Для настройки динамических портов данному параметру должно быть задано нулевое значение.

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

-Protocol

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

Type:Protocols
Accepted values:TCP
Position:1
Default value:None
Required:True
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[]