你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzSqlDatabaseSecondary

模块:

Az.Sql

为现有数据库创建辅助数据库，并开始数据复制。

语法

New-AzSqlDatabaseSecondary
   [-DatabaseName] <String>
   [-SecondaryServiceObjectiveName <String>]
   [-SecondaryElasticPoolName <String>]
   [-Tags <Hashtable>]
   -PartnerResourceGroupName <String>
   -PartnerServerName <String>
   [-PartnerDatabaseName <String>]
   [-AllowConnections <AllowConnections>]
   [-AsJob]
   [-LicenseType <String>]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-ZoneRedundant]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSqlDatabaseSecondary
   [-DatabaseName] <String>
   [-Tags <Hashtable>]
   -PartnerResourceGroupName <String>
   -PartnerServerName <String>
   [-PartnerDatabaseName <String>]
   [-AllowConnections <AllowConnections>]
   [-AsJob]
   -SecondaryComputeGeneration <String>
   -SecondaryVCore <Int32>
   [-SecondaryComputeModel <String>]
   [-LicenseType <String>]
   [-AutoPauseDelayInMinutes <Int32>]
   [-MinimumCapacity <Double>]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-ZoneRedundant]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzSqlDatabaseSecondary cmdlet 在用于为数据库设置异地复制时替换 Start-AzSqlDatabaseCopy cmdlet。 它将异地复制链接对象从主数据库返回到辅助数据库。

示例

示例 1：建立活动异地复制

$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -AllowConnections "All"

示例 2：建立活动异地复制，并指定要与源数据库名称不同的伙伴数据库名称

$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -PartnerDatabaseName $secondarydatabasename -AllowConnections "All"

参数

-AllowConnections

指定辅助Azure SQL 数据库的读取意向。 此参数的可接受值为：

• 否
• All

类型:	AllowConnections
接受的值:	No, All
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AsJob

在后台运行 cmdlet

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AssignIdentity

为此数据库生成并分配一个Microsoft Entra 标识，以用于 Azure KeyVault 等密钥管理服务。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AutoPauseDelayInMinutes

自动暂停延迟（仅限无服务器），-1 选择退出

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BackupStorageRedundancy

用于存储SQL 数据库备份的备份存储冗余。 选项包括：本地、区域和地理位置。

类型:	String
接受的值:	Local, Zone, Geo, GeoZone
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DatabaseName

指定要充当主数据库的数据库的名称。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionProtector

用于SQL 数据库复制的加密保护程序密钥。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionProtectorAutoRotation

AKV 密钥自动轮换状态

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-FederatedClientId

SQL 数据库的联合客户端 ID。 它用于跨租户 CMK 方案。

类型:	Nullable<T>[Guid]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HighAvailabilityReplicaCount

与可路由只读应用程序意向连接的数据库关联的只读次要副本数。 此属性仅适用于超大规模版本数据库。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-KeyList

SQL 数据库副本的 AKV 密钥列表。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LicenseType

Azure Sql 数据库的许可证类型。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MinimumCapacity

辅助数据库始终分配的最小容量（如果未暂停）。 仅适用于无服务器 Azure Sql 数据库。

类型:	Double
别名:	MinVCore, MinCapacity
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PartnerDatabaseName

要创建的辅助数据库的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PartnerResourceGroupName

指定此 cmdlet 向其分配辅助数据库的 Azure 资源组的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PartnerServerName

指定要充当辅助数据库的 Azure SQL 数据库服务器的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

指定此 cmdlet 向其分配主数据库的 Azure 资源组的名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SecondaryComputeGeneration

Azure Sql 数据库辅助数据库的计算生成。

类型:	String
别名:	Family
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SecondaryComputeModel

Azure Sql 数据库辅助数据库的计算模型。 无服务器或预配

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SecondaryElasticPoolName

指定要在其中放置辅助数据库的弹性池的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SecondaryServiceObjectiveName

指定要分配给辅助数据库的服务目标的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SecondaryType

数据库的辅助类型（如果是辅助数据库）。 有效值为 Geo、Named 和 Standby。

类型:	String
接受的值:	Named, Geo, Standby
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SecondaryVCore

Azure Sql 数据库辅助数据库的 Vcore 数。

类型:	Int32
别名:	Capacity
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ServerName

指定主SQL 数据库的 SQL Server 的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Tags

指定要与SQL 数据库复制链接关联的哈希表形式的键值对。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

类型:	Hashtable
别名:	Tag
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UserAssignedIdentityId

SQL 数据库副本的用户分配标识列表。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-ZoneRedundant

要与 Azure Sql 数据库关联的区域冗余。 此属性仅适用于超大规模版本数据库。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

输出

AzureReplicationLinkModel

相关链接

• Remove-AzSqlDatabaseSecondary
• Set-AzSqlDatabaseSecondary
• SQL 数据库文档