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 cmdlet 设置SQL Server的目标实例的网络配置。
SQL Server 云适配器必须在承载 SQL Server 实例的计算机上运行并且可访问它。
此 cmdlet 支持以下操作模式：
- 指定Windows PowerShell路径的实例。
- 指定服务器对象。
- 指定SQL Server的目标实例的 ServerInstance 对象。
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名为Computer\Instance服务器实例的端口1433上的连接。
当前工作目录用于确定操作所在的服务器实例。
不会自动重启SQL Server服务。
自动接受目标计算机的自签名证书，而不会提示用户。
示例 2：使用管道设置目标SQL Server的网络配置
PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer006" | Set-SqlNetworkConfiguration -Credential $Credential -Protocol TCP -Disable -NoServiceRestart -AcceptSelfSignedCertificate;此命令获取命名Computer006计算机上所有SQL Server实例，并禁用TCP其中每个实例的连接。
不会自动重启SQL Server服务。
自动接受目标计算机的自签名证书，而不会提示用户。
参数
-AutomaticallyAcceptUntrustedCertificates
指示此 cmdlet 自动接受不受信任的证书。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Credential
指定目标计算机上具有 Windows 管理员凭据的用户帐户。
| 类型: | PSCredential |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Disable
指示此 cmdlet 在SQL Server的目标实例上禁用指定的网络协议。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceServiceRestart
指示此 cmdlet 强制SQL Server服务在必要时重启，而无需提示用户。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定目标实例的服务器对象的数组。
| 类型: | Server[] |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ManagementPublicPort
指定目标计算机上的公共管理端口。 当目标计算机的端口不可直接访问但通过终结点公开时，将使用此参数。 这意味着此 cmdlet 需要连接到其他端口。
SQL Server 云适配器必须可通过此端口访问。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-NoServiceRestart
指示此 cmdlet 阻止重启SQL Server服务，而无需提示用户。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Path
将此 cmdlet 运行操作的SQL Server实例指定为数组的路径。 如果未为此参数指定值，cmdlet 将使用当前工作位置。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Port
指定要接受 TCP 连接的端口。 要配置动态端口，此参数应设置为零。
| 类型: | Int32 |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Protocol
指定要在 SQL Server 目标实例上配置的网络协议。
| 类型: | Protocols |
| 接受的值: | TCP |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-RetryTimeout
指定在目标服务器上重试命令的时间段。 超时后，将不再重试。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ServerInstance
将实例的名称指定为SQL Server的数组，该数组成为操作的目标。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-WhatIf
显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.SqlServer.Management.Smo.Server[]
System.String[]