Join-SqlAvailabilityGroup
将本地辅助副本 (replica) 加入可用性组。
语法
Join-SqlAvailabilityGroup
[-Name] <String>
[[-Path] <String>]
[-ClusterType <AvailabilityGroupClusterType>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Join-SqlAvailabilityGroup
[-Name] <String>
[-InputObject] <Server>
[-ClusterType <AvailabilityGroupClusterType>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Join-SqlAvailabilityGroup cmdlet 将本地辅助副本 (replica) 加入可用性组。
在承载未加入可用性组的辅助副本 (replica) 的 SQL Server 实例上运行此 cmdlet。
示例
示例 1：将辅助副本 (replica) 加入可用性组
PS C:\> Join-SqlAvailabilityGroup -Path "SQLSERVER:\SQL\SecondaryServer\InstanceName" -Name "MainAG"此命令将辅助副本 (replica) 加入名为“MainAG”的可用性组。 此服务器实例必须承载此可用性组中的辅助副本。
示例 2：创建将辅助副本 (replica) 加入可用性组的脚本
PS C:\> Join-SqlAvailabilityGroup -Path "SQLSERVER:\SQL\SecondaryServer\InstanceName" -Name "MainAG" -Script此命令创建一个 Transact-SQL 脚本，用于将辅助副本 (replica) 联接到名为“MainAG”的可用性组。
参数
-AccessToken
用于对SQL Server进行身份验证的访问令牌，作为用户/密码或 Windows 身份验证的替代方法。
例如，这可用于连接到 SQL Azure DB 和使用 SQL Azure Managed InstanceService Principal 或 Managed Identity。
要使用的参数可以是表示令牌的字符串，也可以是 PSAccessToken 运行 Get-AzAccessToken -ResourceUrl https://database.windows.net返回的对象。
此参数是模块 v22 中的新增参数。
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClusterType
支持 AG 的群集类型。 可能的值为：
- Wsfc。 AG 将集成到 Windows Server 故障转移群集中。 这是 2016 年及更低SQL Server中 AG 的创建方式。 这是默认值。
- 无。 AG 将与群集无关。
- 外部。 AG 将由不是 Windows Server 故障转移群集的群集管理器（如 Linux 上的 Pacemaker）管理。 2017 年及更高版本SQL Server支持此功能。 以Linux 上的 SQL Server为目标时，必须指定此值，否则会出现错误。
| Type: | AvailabilityGroupClusterType |
| Accepted values: | Wsfc, None, External |
| Position: | Named |
| Default value: | Wsfc |
| 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 |
-Encrypt
连接到SQL Server时使用的加密类型。
此值映射到 Encrypt Microsoft.Data.SqlClient 驱动程序的 SqlConnection 对象上的 属性 SqlConnectionEncryptOption 。
在模块的 v22 中，默认 Optional 为 (，以便与 v21) 兼容。 在模块的 v23+ 中，默认值为“必需”，这可能会为现有脚本创建中断性变更。
此参数是模块 v22 中的新增参数。
| Type: | String |
| Accepted values: | Mandatory, Optional, Strict |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostNameInCertificate
验证 SQL Server TLS/SSL 证书时要使用的主机名。 如果SQL Server实例启用了强制加密，并且你想要使用主机名/shortname 连接到实例，则必须传递此参数。 如果省略此参数，则必须将完全限定的域名 (FQDN) 传递给 -ServerInstance 才能连接到启用强制加密的SQL Server实例。
此参数是模块 v22 中的新增参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定托管 SQL Server 实例的服务器，该实例托管此 cmdlet 加入可用性组的辅助副本 (replica) 。
| Type: | Server |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定此 cmdlet 加入辅助副本 (replica) 的可用性组的名称。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定SQL Server实例的路径，该实例承载此 cmdlet 加入到可用性组的辅助副本 (replica) 。 如果未指定此参数，则此 cmdlet 将使用当前工作位置。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Script
指示此 cmdlet 返回执行此 cmdlet 执行的任务的 Transact-SQL 脚本。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrustServerCertificate
指示是否在绕过证书链以验证信任时对通道进行加密。
在模块的 v22 中，默认 $true 为 (，以便与 v21) 兼容。 在模块的 v23+ 中，默认值为“$false”，这可能会为现有脚本创建中断性变更。
此参数是模块 v22 中的新增参数。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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
可以将服务器实例传递给此 cmdlet。
备注
必须在服务器实例上启用高可用性数据恢复服务。 Path 参数指定的可用性副本 (replica) 必须存在。