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