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[]