Set-SqlNetworkConfiguration
Задает конфигурацию сети целевого экземпляра 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
Указывает, что этот командлет автоматически принимает недоверенные сертификаты.
Тип: | 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 |
-Disable
Указывает, что этот командлет отключает указанный сетевой протокол в целевом экземпляре SQL Server.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceServiceRestart
Указывает, что этот командлет принудительно перезапускает службу SQL Server при необходимости без запроса пользователя.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Указывает массив объектов сервера целевого экземпляра.
Тип: | Server[] |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ManagementPublicPort
Указывает порт общедоступного управления на целевом компьютере. Этот параметр используется, если порты целевого компьютера недоступны напрямую, но предоставляются через конечные точки. Это означает, что этот командлет должен подключиться к другому порту.
SQL Server Cloud Adapter должен быть доступен по данному порту.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NoServiceRestart
Указывает, что этот командлет предотвращает перезапуск службы SQL Server без запроса пользователя.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Path
Указывает путь в виде массива к экземпляру SQL Server, в котором этот командлет выполняет операцию. Если для этого параметра не указано значение, командлет использует текущее рабочее расположение.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Port
Указывает порт для приема TCP-подключений. Для настройки динамических портов данному параметру должно быть задано нулевое значение.
Тип: | Int32 |
Position: | 2 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Protocol
Задает сетевой протокол, который следует настроить на целевом экземпляре SQL Server.
Тип: | Protocols |
Допустимые значения: | TCP |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | 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[]