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

New-AzSqlDatabaseExport

模块:: Az.Sql Module

将 Azure SQL 数据库作为 .bacpac 文件导出到存储帐户。

语法

Default (默认值)

New-AzSqlDatabaseExport
    [-DatabaseName] <String>
    [-ServerName] <String>
    -StorageKeyType <StorageKeyType>
    -StorageKey <String>
    -StorageUri <Uri>
    -AdministratorLogin <String>
    -AdministratorLoginPassword <SecureString>
    [-AuthenticationType <AuthenticationType>]
    [-UseNetworkIsolation <Boolean>]
    [-StorageAccountResourceIdForPrivateLink <String>]
    [-SqlServerResourceIdForPrivateLink <String>]
    [-ResourceGroupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

New-AzSqlDatabaseExport cmdlet 将 Azure SQL 数据库作为 .bacpac 文件导出到存储帐户。可以发送获取导出数据库状态请求来检索此请求的状态信息。 Azure 上的 SQL Server Stretch Database 服务也支持此 cmdlet。

重要

若要使用此 cmdlet，需要将 Azure SQL Server 上的防火墙配置为“允许 Azure 服务和资源访问此服务器”。如果未配置此配置，将遇到 GatewayTimeout 错误。如果通过 UseNetworkIsolation 参数建立专用链接连接，则不需要这样做。

示例

示例 1：为数据库创建导出请求

New-AzSqlDatabaseExport -ResourceGroupName "RG01" -ServerName "Server01" -DatabaseName "Database01" -StorageKeyType "StorageAccessKey" -StorageKey "StorageKey01" -StorageUri "http://account01.blob.core.contoso.net/bacpacs/database01.bacpac" -AdministratorLogin "User" -AdministratorLoginPassword "secure password"

ResourceGroupName          : RG01
ServerName                 : Server01
DatabaseName               : Database01
StorageKeyType             : StorageAccessKey
StorageKey                 :
StorageUri                 : http://account01.blob.core.contoso.net/bacpacs/database01.bacpac
AdministratorLogin         : User
AdministratorLoginPassword :
AuthenticationType         : None
OperationStatusLink        : https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource01/providers/Microsoft.Sql/servers/server01/databases/database01/importExportOperationResults/00000000-00
                             0-0000-0000-000000000000?api-version=2014-04-01
Status                     : InProgress
ErrorMessage               :

此命令为指定的数据库创建导出请求。

示例 2：使用托管标识通过专用链接进行身份验证的数据库创建导出请求

$sqlServerName = "Server01"
$storageAccountName = "storageaccount1"
$subscriptionId = "00000000-0000-0000-0000-000000000000"
$resourceGroup = "RG01"
$managedIdentityResourceId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-managed-identity"
$pw = ConvertTo-SecureString "******" -AsPlainText -Force
New-AzSqlDatabaseExport `
    -ResourceGroupName $resourceGroup `
    -ServerName $sqlServerName `
    -DatabaseName "Database01" `
    -StorageKeyType ManagedIdentity `
    -StorageKey $managedIdentityResourceId `
    -StorageUri "https://storageaccount1.blob.core.windows.net/container1/my-file-name.bacpac" `
    -AuthenticationType ManagedIdentity `
    -AdministratorLogin $managedIdentityResourceId `
    -AdministratorLoginPassword $pw `
    -UseNetworkIsolation $true `
    -SqlServerResourceIdForPrivateLink "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.Sql/servers/$sqlServerName" `
    -StorageAccountResourceIdForPrivateLink "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.Storage/storageAccounts/$storageAccountName"

此命令使用托管标识通过专用链接进行连接身份验证，为指定的数据库创建导出请求。

参数

-AdministratorLogin

指定 SQL 管理员的名称。

如果 -AuthenticationType ManagedIdentity 已提供，则这应该是用户分配的托管标识的完整资源 ID，该标识是服务器的 Microsoft Entra 管理员。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AdministratorLoginPassword

指定 SQL 管理员的密码。

参数属性

类型:	SecureString
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AuthenticationType

指定用于访问服务器的身份验证类型。如果未设置身份验证类型，则默认值为 SQL。此参数的可接受值为：

Sql。 SQL 身份验证。将 AdministratorLogin 和 AdministratorLoginPassword 设置为 SQL 管理员用户名和密码。
ADPassword。 Microsoft Entra 身份验证。将 AdministratorLogin 和 AdministratorLoginPassword 设置为 Microsoft Entra 管理员用户名和密码。此参数仅在 SQL 数据库 V12 服务器上可用。
ManagedIdentity。托管标识身份验证。使用用户分配的托管标识通过 SQL Server 进行身份验证。托管标识必须是服务器的 Microsoft Entra 管理员。

参数属性

类型:	AuthenticationType
默认值:	None
接受的值:	None, Sql, AdPassword, ManagedIdentity
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DatabaseName

指定 SQL 数据库的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	2
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

指定 SQL 数据库服务器的资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ServerName

指定 SQL 数据库服务器的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-SqlServerResourceIdForPrivateLink

用于创建专用链接的 sql Server 资源 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-StorageAccountResourceIdForPrivateLink

用于创建专用链接的存储帐户资源 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-StorageKey

指定存储帐户的访问密钥。

提供时 -StorageKeyType ManagedIdentity ，这应该是用户分配的托管标识的完整资源 ID，该标识在提供的 StorageUri 的存储帐户上具有写入访问权限（例如，通过存储 Blob 数据参与者角色分配）。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-StorageKeyType

指定存储帐户的访问密钥的类型。此参数的可接受值为：

StorageAccessKey。此值使用存储帐户密钥。
SharedAccessKey。此值使用共享访问签名（SAS）密钥。
ManagedIdentity。使用用户分配的托管标识通过存储帐户进行身份验证。

参数属性

类型:	StorageKeyType
默认值:	None
接受的值:	StorageAccessKey, SharedAccessKey, ManagedIdentity
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-StorageUri

重要

参数属性

类型:	Uri
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UseNetworkIsolation

如果已设置，将为存储帐户和/或 SQL Server 创建专用链接

参数属性

类型:	Boolean
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

输入

String

输出

AzureSqlDatabaseImportExportBaseModel

备注

关键字：azure， azurerm， arm，资源，管理，经理， sql，数据库， mssql

反馈

此页面是否有帮助？

通过

New-AzSqlDatabaseExport

语法

Default (默认值)

说明

示例

示例 1：为数据库创建导出请求

示例 2：使用托管标识通过专用链接进行身份验证的数据库创建导出请求

参数

-AdministratorLogin

参数属性

参数集

-AdministratorLoginPassword

参数属性

参数集

-AuthenticationType

参数属性

参数集

-Confirm

参数属性

参数集

-DatabaseName

参数属性

参数集

-DefaultProfile

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-ServerName

参数属性

参数集

-SqlServerResourceIdForPrivateLink

参数属性

参数集

-StorageAccountResourceIdForPrivateLink

参数属性

参数集

-StorageKey

参数属性

参数集

-StorageKeyType

参数属性

参数集

-StorageUri

参数属性

参数集

-UseNetworkIsolation

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

String

输出

AzureSqlDatabaseImportExportBaseModel

备注

相关链接

反馈