Disable-SqlAlwaysOn
停用伺服器的 AlwaysOn 可用性群組功能。
語法
Disable-SqlAlwaysOn
[[-Path] <String>]
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-SqlAlwaysOn
[-InputObject] <Server>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-SqlAlwaysOn
-ServerInstance <String>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Disable-SqlAlwaysOn Cmdlet 會停用 SQL Server 實例上的 Always On 可操作性群組功能。
如果在 SQL Server 服務執行時停用 AlwaysOn 可用性群組功能,則必須重新啟動資料庫引擎服務,才能完成變更。
除非您指定 Force 參數,否則 Cmdlet 會提示您重新啟動服務。
如果AlwaysOn可用性群組功能已停用,此 Cmdlet 不會進行任何變更。
此 Cmdlet 可以針對遠端服務執行。
您必須具有系統管理員許可權才能執行此 Cmdlet。
Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.
範例
範例 1:在指定的路徑停用 AlwaysOn 可用性群組
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"
此命令會在位於指定路徑的 SQL Server 實例上停用 Always On 可用性群組。 此命令需要重新啟動伺服器實例,系統會提示您確認此重新啟動。
範例 2:在指定的路徑停用 AlwaysOn 可用性群組,並在不確認的情況下重新啟動伺服器
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force
此命令會在位於指定路徑的 SQL Server 實例上停用 Always On 可用性群組。 Force 選項會使伺服器實例重新啟動,而不會提示您進行確認。
範例 3:針對指定的伺服器實例停用 AlwaysOn 可用性群組
PS C:\> Disable-SqlAlwaysOn -ServerInstance "Computer\Instance"
此命令會在名為 『Computer\Instance』 的 SQL Server 實例上停用 AlwaysOn 可用性群組。 此命令需要重新啟動 實例,系統會提示您確認此重新啟動。
範例 4:使用 Windows 驗證停用指定伺服器實例的 AlwaysOn 可用性群組
PS C:\> Disable-SqlAlwaysOn -ServerInstance "Computer\Instance" -Credential (Get-Credential "DOMAIN\Username")
此命令會使用 Windows 驗證,在名為 『Computer\Instance』 的 SQL Server 實例上停用 AlwaysOn 可用性群組。 系統會提示您輸入指定帳戶 『DOMAIN\Username』 的密碼。 此變更需要重新啟動實例,而且系統也會提示您確認此重新啟動。
範例 5:在指定的路徑停用 AlwaysOn 可用性群組,而不重新啟動伺服器
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -NoServiceRestart
此命令會在位於指定路徑的 SQL Server 實例上停用 Always On 可用性群組,但命令不會重新啟動實例。 在您手動重新啟動此伺服器實例之前,變更才會生效。
參數
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Credential
指定具有變更 SQL Server 實例上 Always On 設定許可權的 Windows 認證。
類型: | PSCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
強制命令執行,而不要求使用者確認。 提供此參數以允許文本的建構。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定停用 Always On 可用性群組設定之 SQL Server 實例的伺服器物件。
類型: | Server |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-NoServiceRestart
表示不會提示使用者重新啟動 SQL Server 服務。 您必須手動重新啟動 SQL Server 服務,變更才會生效。 設定此參數時,會忽略 Force。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Path
指定 SQL Server 實例的路徑。 這是選擇性參數。 如果未指定,則會使用目前工作位置的值。
類型: | String |
Position: | 1 |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ProgressAction
決定 PowerShell 如何回應腳本、Cmdlet 或提供者所產生的進度更新,例如 Write-Progress Cmdlet 所產生的進度列。 Write-Progress Cmdlet 會建立顯示命令狀態的進度列。
類型: | ActionPreference |
別名: | proga |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ServerInstance
指定停用 Always On 之 SQL Server 實例的名稱。 格式應該是 MACHINENAME\INSTANCE。 使用 Credential 參數來變更遠端伺服器上的 Always On 設定。
類型: | 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
輸出
System.Object