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>]

Description

New-AzSqlDatabaseExport Cmdlet 會將 Azure SQL 資料庫匯出為 .bacpac 檔案至儲存體帳戶。 可以傳送取得匯出資料庫狀態要求，以擷取此要求的狀態資訊。 Azure 上的 SQL Server Stretch Database 服務也支援此 Cmdlet。

這很重要

若要使用此 Cmdlet，Azure SQL Server 上的防火牆必須設定為「允許 Azure 服務和資源存取此伺服器」。 如果未設定此設定，則會發生 GatewayTimeout 錯誤。 如果透過 UseNetworkIsolation 參數建立 Private Link 連線，則不需要這樣做。

範例

範例 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"

此命令會使用受控識別來建立指定資料庫的匯出要求，以透過 Private Link 進行連線驗證。

參數

-AdministratorLogin

指定 SQL 管理員的名稱。

如果提供，這 -AuthenticationType ManagedIdentity 應該是使用者指派的受控識別的完整資源識別碼，該識別是伺服器的 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 Database V12 伺服器。
• ManagedIdentity 的 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
別名:	參見

參數集

(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 Database 伺服器的資源群組名稱。

參數屬性

類型:	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 資源識別碼

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageAccountResourceIdForPrivateLink

用於建立私人連結的儲存體帳戶資源識別碼

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageKey

指定儲存體帳戶的存取金鑰。

提供時 -StorageKeyType ManagedIdentity ，這應該是使用者指派的受控識別的完整資源識別碼，該識別具有所提供 StorageUri 儲存體帳戶的寫入存取權 （例如，透過 儲存體 Blob 資料參與者 角色指派）。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageKeyType

指定儲存體帳戶的存取金鑰類型。 此參數可接受的值為：

• StorageAccessKey。 此值會使用儲存體帳戶金鑰。
• SharedAccessKey。 此值會使用共用存取簽章 （SAS） 金鑰。
• ManagedIdentity 的 ManagedIdentity 來定義。 使用使用者指派的受控識別，對儲存體帳戶進行驗證。

參數屬性

類型:	StorageKeyType
預設值:	None
接受的值:	StorageAccessKey, SharedAccessKey, ManagedIdentity
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageUri

New-AzSqlDatabaseExport Cmdlet 會將 Azure SQL 資料庫匯出為 .bacpac 檔案至儲存體帳戶。 可以傳送取得匯出資料庫狀態要求，以擷取此要求的狀態資訊。 Azure 上的 SQL Server Stretch Database 服務也支援此 Cmdlet。

這很重要

若要使用此 Cmdlet，Azure SQL Server 上的防火牆必須設定為「允許 Azure 服務和資源存取此伺服器」。 如果未設定此設定，則會發生 GatewayTimeout 錯誤。 如果透過 UseNetworkIsolation 參數建立 Private Link 連線，則不需要這樣做。

參數屬性

類型:	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、resource、management、manager、sql、database、mssql

相關連結

• Get-AzSqlDatabaseImportExportStatus
• New-AzSqlDatabaseImport
• SQL 資料庫檔