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 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名为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;

此命令获取命名 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 运行时会发生什么情况。命令脚本未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

SQLServer_Cmdlets

通过