New-AzSqlDatabaseExport

Modul:

Az.Sql Module

Mengekspor Azure SQL Database sebagai file .bacpac ke akun penyimpanan.

Sintaks

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

Deskripsi

Cmdlet New-AzSqlDatabaseExport mengekspor Azure SQL Database sebagai file .bacpac ke akun penyimpanan. Permintaan dapatkan status database ekspor dapat dikirim untuk mengambil informasi status untuk permintaan ini. Cmdlet ini juga didukung oleh layanan SQL Server Stretch Database di Azure.

Penting

Untuk menggunakan cmdlet ini, firewall di Azure SQL Server perlu dikonfigurasi ke "Izinkan layanan dan sumber daya Azure untuk mengakses server ini". Jika ini tidak dikonfigurasi, maka kesalahan GatewayTimeout akan dialami. Ini tidak diperlukan jika koneksi Private Link dibuat melalui parameter UseNetworkIsolation.

Contoh

Contoh 1: Membuat permintaan ekspor untuk database

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               :

Perintah ini membuat permintaan ekspor untuk database yang ditentukan.

Contoh 2: Membuat permintaan ekspor untuk database menggunakan identitas terkelola untuk autentikasi melalui tautan privat

$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"

Perintah ini membuat permintaan ekspor untuk database yang ditentukan menggunakan identitas terkelola untuk autentikasi dengan konektivitas melalui Private Link.

Parameter

-AdministratorLogin

Menentukan nama administrator SQL.

Jika -AuthenticationType ManagedIdentity disediakan, ini harus menjadi ID sumber daya lengkap dari identitas terkelola yang ditetapkan pengguna yang merupakan administrator Microsoft Entra dari server.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-AdministratorLoginPassword

Menentukan kata sandi administrator SQL.

Properti parameter

Jenis:	SecureString
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-AuthenticationType

Menentukan jenis autentikasi yang digunakan untuk mengakses server. Nilai defaultnya adalah SQL jika tidak ada jenis autentikasi yang diatur. Nilai yang dapat diterima untuk parameter ini adalah:

• Sql. Autentikasi SQL. Atur AdministratorLogin dan AdministratorLoginPassword ke nama pengguna dan kata sandi administrator SQL.
• Kata sandi AD. Autentikasi Microsoft Entra. Atur AdministratorLogin dan AdministratorLoginPassword ke nama pengguna dan kata sandi administrator Microsoft Entra. Parameter ini hanya tersedia di server SQL Database V12.
• ManagedIdentity. Autentikasi identitas terkelola. Gunakan identitas terkelola yang ditetapkan pengguna untuk mengautentikasi dengan server SQL. Identitas terkelola harus menjadi administrator Microsoft Entra untuk server.

Properti parameter

Jenis:	AuthenticationType
Nilai default:	None
Nilai yang diterima:	None, Sql, AdPassword, ManagedIdentity
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DatabaseName

Menentukan nama SQL Database.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	2
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure

Properti parameter

Jenis:	IAzureContextContainer
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ResourceGroupName

Menentukan nama grup sumber daya untuk server SQL Database.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ServerName

Menentukan nama server SQL Database.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-SqlServerResourceIdForPrivateLink

Id sumber daya server sql untuk membuat tautan privat

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-StorageAccountResourceIdForPrivateLink

Id sumber daya akun penyimpanan untuk membuat tautan privat

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-StorageKey

Menentukan kunci akses untuk akun penyimpanan.

Ketika -StorageKeyType ManagedIdentity disediakan, ini harus menjadi ID sumber daya lengkap dari identitas terkelola yang ditetapkan pengguna yang memiliki akses tulis pada akun penyimpanan untuk StorageUri yang disediakan (misalnya melalui penetapan peran Kontributor Data Blob Penyimpanan ).

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-StorageKeyType

Menentukan jenis kunci akses untuk akun penyimpanan. Nilai yang dapat diterima untuk parameter ini adalah:

• StorageAccessKey. Nilai ini menggunakan kunci akun penyimpanan.
• SharedAccessKey. Nilai ini menggunakan kunci Tanda Tangan Akses Bersama (SAS).
• ManagedIdentity. Gunakan identitas terkelola yang ditetapkan pengguna untuk autentikasi dengan akun penyimpanan.

Properti parameter

Jenis:	StorageKeyType
Nilai default:	None
Nilai yang diterima:	StorageAccessKey, SharedAccessKey, ManagedIdentity
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-StorageUri

Cmdlet New-AzSqlDatabaseExport mengekspor Azure SQL Database sebagai file .bacpac ke akun penyimpanan. Permintaan dapatkan status database ekspor dapat dikirim untuk mengambil informasi status untuk permintaan ini. Cmdlet ini juga didukung oleh layanan SQL Server Stretch Database di Azure.

Penting

Untuk menggunakan cmdlet ini, firewall di Azure SQL Server perlu dikonfigurasi ke "Izinkan layanan dan sumber daya Azure untuk mengakses server ini". Jika ini tidak dikonfigurasi, maka kesalahan GatewayTimeout akan dialami. Ini tidak diperlukan jika koneksi Private Link dibuat melalui parameter UseNetworkIsolation.

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-UseNetworkIsolation

Jika diatur, akan membuat tautan privat untuk akun penyimpanan dan/atau server SQL

Properti parameter

Jenis:	Boolean
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

Output

AzureSqlDatabaseImportExportBaseModel

Catatan

• Kata kunci: azure, azurerm, arm, sumber daya, manajemen, manajer, sql, database, mssql

Link Terkait

• Get-AzSqlDatabaseImportExportStatus
• New-AzSqlDatabaseImport
• Dokumentasi SQL Database