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>]
说明
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 实例上启用 AlwaysOn 可用性组。 此更改需要重启实例,系统会提示你确认此重启。
示例 2:在指定路径上启用 AlwaysOn 可用性组,并在未确认的情况下重启服务器
PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force
此命令在位于指定路径的 SQL Server 实例上启用 AlwaysOn 可用性组。 Force 选项会导致服务器实例重启,而不会提示你进行确认。
示例 3:为指定的服务器实例启用 AlwaysOn 可用性组
PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance"
此命令在名为 Computer\Instance 的 SQL Server 实例上启用 AlwaysOn 可用性组。 此更改需要重启实例,系统会提示你确认此重启。
示例 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 实例上启用 AlwaysOn 可用性组,但该命令不会重启该实例。 在手动重启此服务器实例之前,更改才会生效。
参数
-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