Set-SqlNetworkConfiguration
設定目標 SQL Server 執行個體的網路組態。
Syntax
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>] 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 。
第二個命令會設定網路組態，以接受 TCP1433 名為 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 會自動接受不受信任的憑證。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
指定目的電腦上具有 Windows 系統管理員認證的使用者帳戶。
| Type: | PSCredential |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Disable
表示此 Cmdlet 會停用目標實例上SQL Server的指定網路通訊協定。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceServiceRestart
表示此 Cmdlet 會強制SQL Server服務視需要重新開機，而不提示使用者。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定目標實例的伺服器物件陣列。
| Type: | Server[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagementPublicPort
指定目的電腦上的公用管理埠。 當目的電腦的埠無法直接存取，但會透過端點公開時，就會使用此參數。 這表示此 Cmdlet 必須連線到不同的埠。
SQL Server 雲端配接器必須以此連接埠存取。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoServiceRestart
表示此 Cmdlet 會防止重新開機SQL Server服務，而不提示使用者。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定此 Cmdlet 執行作業之SQL Server實例的路徑，做為陣列。 如果您未指定此參數的值，Cmdlet 會使用目前的工作位置。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Port
指定要接受 TCP 連線的埠。 若要設定動態連接埠，此參數應設為零。
| Type: | Int32 |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
指定想在目標 SQL Server 執行個體上設定的網路通訊協定。
| Type: | Protocols |
| Accepted values: | TCP |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RetryTimeout
指定在目標伺服器上重試命令的時間週期。 超過逾時設定之後，就不會再嘗試重試。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServerInstance
指定實例的名稱，作為成為作業目標的SQL Server陣列。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
Microsoft.SqlServer.Management.Smo.Server[]
System.String[]