Set-SqlNetworkConfiguration

模块:: SqlServer Module

设置 SQL Server 目标实例的网络配置。

语法

ByPath （默认值）

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

ByObject

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

ByName

Set-SqlNetworkConfiguration
    [-Protocol] <Protocols>
    [[-Port] <Int32>]
    [-Credential] <PSCredential>
    -ServerInstance <String[]>
    [-Disable]
    [-ForceServiceRestart]
    [-NoServiceRestart]
    [-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
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Credential

指定目标计算机上具有 Windows 管理员凭据的用户帐户。

参数属性

类型:	PSCredential
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Disable

指示此 cmdlet 在 SQL Server 的目标实例上禁用指定的网络协议。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ForceServiceRestart

指示此 cmdlet 强制 SQL Server 服务在必要时重启，而无需提示用户。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputObject

指定目标实例的服务器对象的数组。

参数属性

类型:	Server[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByObject

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagementPublicPort

指定目标计算机上的公共管理端口。当目标计算机的端口不可直接访问但通过终结点公开时，将使用此参数。这意味着此 cmdlet 需要连接到其他端口。

SQL Server 云适配器必须可通过此端口访问。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-NoServiceRestart

指示此 cmdlet 可防止重启 SQL Server 服务而不提示用户。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Path

指定此 cmdlet 运行作的 SQL Server 实例的路径（作为数组）。如果未为此参数指定值，cmdlet 将使用当前工作位置。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByPath

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Port

指定要接受 TCP 连接的端口。若要配置动态端口，此参数应设置为零。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	2
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Protocol

指定要在 SQL Server 的目标实例上配置的网络协议。

参数属性

类型:	Protocols
默认值:	None
接受的值:	TCP
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RetryTimeout

指定要在目标服务器上重试命令的时间段。超时过期后，不会尝试重试。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ServerInstance

将实例的名称指定为 SQL Server 的数组，该数组成为作的目标。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByName

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

Set-SqlNetworkConfiguration

语法

ByPath （默认值）

ByObject

ByName

说明

示例

示例 1：设置目标 SQL Server 的网络配置

示例 2：使用管道设置目标 SQL Server 的网络配置

参数

-AutomaticallyAcceptUntrustedCertificates

参数属性

参数集

-Confirm

参数属性

参数集

-Credential

参数属性

参数集

-Disable

参数属性

参数集

-ForceServiceRestart

参数属性

参数集

-InputObject

参数属性

参数集

-ManagementPublicPort

参数属性

参数集

-NoServiceRestart

参数属性

参数集

-Path

参数属性

参数集

-Port

参数属性

参数集

-Protocol

参数属性

参数集

-RetryTimeout

参数属性

参数集

-ServerInstance

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

Microsoft.SqlServer.Management.Smo.Server

System.String

相关链接

反馈