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

Description

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。

輸入

Microsoft.SqlServer.Management.Smo.Server

System.String

相關連結

• SQLServer_Cmdlets