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