New-AzSqlDatabaseExport

Modül:

Az.Sql Module

Bir Azure SQL Veritabanını .bacpac dosyası olarak bir depolama hesabına aktarır.

Syntax

Default (Varsayılan)

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'i bir Azure SQL Veritabanını .bacpac dosyası olarak bir depolama hesabına aktarır. Bu isteğin durum bilgilerini almak için dışarı aktarma veritabanı durum isteği gönderilebilir. Bu cmdlet, Azure'da SQL Server Stretch Database hizmeti tarafından da desteklenir.

Önemli

Bu cmdlet'i kullanabilmek için Azure SQL Server'daki güvenlik duvarının "Azure hizmetlerinin ve kaynaklarının bu sunucuya erişmesine izin ver" olarak yapılandırılması gerekir. Bu yapılandırılmamışsa GatewayTimeout hatalarıyla karşılaşılır. UseNetworkIsolation parametresi aracılığıyla Özel Bağlantı bağlantısı kuruluyorsa bu gerekli değildir.

Örnekler

Örnek 1: Veritabanı için dışarı aktarma isteği oluşturma

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               :

Bu komut, belirtilen veritabanı için bir dışarı aktarma isteği oluşturur.

Örnek 2: Özel bağlantı üzerinden kimlik doğrulaması için yönetilen kimlik kullanarak veritabanı için dışarı aktarma isteği oluşturma

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

Bu komut, Özel Bağlantı üzerinden bağlantıyla kimlik doğrulaması için yönetilen kimlik kullanarak belirtilen veritabanı için bir dışarı aktarma isteği oluşturur.

Parametreler

-AdministratorLogin

SQL yöneticisinin adını belirtir.

Sağlanırsa -AuthenticationType ManagedIdentity , bu, sunucunun Microsoft Entra yöneticisi olan kullanıcı tarafından atanan yönetilen kimliğin tam kaynak kimliği olmalıdır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-AdministratorLoginPassword

SQL yöneticisinin parolasını belirtir.

Parametre özellikleri

Tür:	SecureString
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-AuthenticationType

Sunucuya erişmek için kullanılan kimlik doğrulama türünü belirtir. Kimlik doğrulama türü ayarlı değilse varsayılan değer SQL'dir. Bu parametre için kabul edilebilir değerler şunlardır:

• SQL. SQL kimlik doğrulaması. AdministratorLogin ve AdministratorLoginPassword'u SQL yöneticisi kullanıcı adı ve parolası olarak ayarlayın.
• ADPassword. Microsoft Entra kimlik doğrulaması. AdministratorLogin ve AdministratorLoginPassword'u Microsoft Entra yönetici kullanıcı adı ve parolası olarak ayarlayın. Bu parametre yalnızca SQL Veritabanı V12 sunucularında kullanılabilir.
• ManagedIdentity. Yönetilen kimlik kimlik doğrulaması. SQL sunucusuyla kimlik doğrulaması yapmak için kullanıcı tarafından atanan yönetilen kimliği kullanın. Yönetilen kimlik, sunucu için bir Microsoft Entra yöneticisi olmalıdır.

Parametre özellikleri

Tür:	AuthenticationType
Default value:	None
Kabul edilen değerler:	None, Sql, AdPassword, ManagedIdentity
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DatabaseName

SQL Veritabanının adını belirtir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	2
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Parametre özellikleri

Tür:	IAzureContextContainer
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ResourceGroupName

SQL Veritabanı sunucusunun kaynak grubunun adını belirtir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ServerName

SQL Veritabanı sunucusunun adını belirtir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	1
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SqlServerResourceIdForPrivateLink

Özel bağlantı oluşturmak için sql server kaynak kimliği

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-StorageAccountResourceIdForPrivateLink

Özel bağlantı oluşturmak için depolama hesabı kaynak kimliği

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-StorageKey

Depolama hesabının erişim anahtarını belirtir.

Sağlandığında -StorageKeyType ManagedIdentity , bu, sağlanan StorageUri için depolama hesabında yazma erişimi olan kullanıcı tarafından atanan yönetilen kimliğin tam kaynak kimliği olmalıdır (örneğin , Depolama Blob Verileri Katkıda Bulunanı rol ataması yoluyla).

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-StorageKeyType

Depolama hesabı için erişim anahtarının türünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

• StorageAccessKey. Bu değer bir depolama hesabı anahtarı kullanır.
• SharedAccessKey. Bu değer Paylaşılan Erişim İmzası (SAS) anahtarı kullanır.
• ManagedIdentity. Depolama hesabıyla kimlik doğrulaması için kullanıcı tarafından atanan bir yönetilen kimlik kullanın.

Parametre özellikleri

Tür:	StorageKeyType
Default value:	None
Kabul edilen değerler:	StorageAccessKey, SharedAccessKey, ManagedIdentity
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-StorageUri

New-AzSqlDatabaseExport cmdlet'i bir Azure SQL Veritabanını .bacpac dosyası olarak bir depolama hesabına aktarır. Bu isteğin durum bilgilerini almak için dışarı aktarma veritabanı durum isteği gönderilebilir. Bu cmdlet, Azure'da SQL Server Stretch Database hizmeti tarafından da desteklenir.

Önemli

Bu cmdlet'i kullanabilmek için Azure SQL Server'daki güvenlik duvarının "Azure hizmetlerinin ve kaynaklarının bu sunucuya erişmesine izin ver" olarak yapılandırılması gerekir. Bu yapılandırılmamışsa GatewayTimeout hatalarıyla karşılaşılır. UseNetworkIsolation parametresi aracılığıyla Özel Bağlantı bağlantısı kuruluyorsa bu gerekli değildir.

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-UseNetworkIsolation

Ayarlanırsa, depolama hesabı ve/veya SQL sunucusu için özel bağlantı oluşturur

Parametre özellikleri

Tür:	Boolean
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Çıkışlar

AzureSqlDatabaseImportExportBaseModel

Notlar

• Anahtar sözcükler: azure, azurerm, arm, resource, management, manager, sql, database, mssql

İlişkili Bağlantılar

• Get-AzSqlDatabaseImportExportStatus
• New-AzSqlDatabaseImport
• SQL Veritabanı Belgeleri