Freigeben über

New-AzSqlDatabaseExport

Modul:
Az.Sql Module

Exportiert eine Azure SQL-Datenbank als BACPAC-Datei in ein Speicherkonto.

Syntax

Default (Standard) 

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

Beschreibung

Das Cmdlet New-AzSqlDatabaseExport exportiert eine Azure SQL-Datenbank als BACPAC-Datei in ein Speicherkonto. Die Anforderung zum Abrufen des Exportdatenbankstatus kann gesendet werden, um Statusinformationen für diese Anforderung abzurufen. Dieses Cmdlet wird auch vom SQL Server Stretch Database Dienst auf Azure unterstützt.

Von Bedeutung

Um dieses Cmdlet nutzen zu können, muss die Firewall auf der Azure SQL Server so konfiguriert werden, dass "Azure Dienste und Ressourcen für den Zugriff auf diesen Server zulassen" konfiguriert werden. Wenn dies nicht konfiguriert ist, werden GatewayTimeout-Fehler auftreten. Dies ist nicht erforderlich, wenn über den Parameter UseNetworkIsolation eine Private Link Verbindung hergestellt wird.

Beispiele

Beispiel 1: Erstellen einer Exportanforderung für eine Datenbank

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               :

Mit diesem Befehl wird eine Exportanforderung für die angegebene Datenbank erstellt.

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

Mit diesem Befehl wird eine Exportanforderung für die angegebene Datenbank mithilfe der verwalteten Identität für die Authentifizierung mit Konnektivität über Private Link erstellt.

Parameter

-AdministratorLogin

Gibt den Namen des SQL-Administrators an.

Wenn -AuthenticationType ManagedIdentity angegeben wird, sollte dies die vollständige Ressourcen-ID einer vom Benutzer zugewiesenen verwalteten Identität sein, die ein Microsoft Entra Administrator des Servers ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AdministratorLoginPassword

Gibt das Kennwort des SQL-Administrators an.

Parametereigenschaften

Typ:SecureString
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AuthenticationType

Gibt den Typ der Authentifizierung an, die für den Zugriff auf den Server verwendet wird. Der Standardwert ist SQL, wenn kein Authentifizierungstyp festgelegt ist. Die zulässigen Werte für diesen Parameter sind:

  • Sql. SQL-Authentifizierung. Legen Sie " AdministratorLogin " und " AdministratorLoginPassword " auf den BENUTZERNAMEN und das Kennwort des SQL-Administrators fest.
  • ADPassword. Microsoft Entra Authentifizierung. Legen Sie AdministratorLogin und AdministratorLoginPassword auf den Benutzernamen und das Kennwort des Microsoft Entra Administrators fest. Dieser Parameter ist nur auf SQL-Datenbank-V12-Servern verfügbar.
  • ManagedIdentity. Verwaltete Identitätsauthentifizierung. Verwenden Sie eine vom Benutzer zugewiesene verwaltete Identität, um sich mit dem SQL-Server zu authentifizieren. Die verwaltete Identität muss ein Microsoft Entra Administrator für den Server sein.

Parametereigenschaften

Typ:AuthenticationType
Standardwert:None
Zulässige Werte:None, Sql, AdPassword, ManagedIdentity
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DatabaseName

Gibt den Namen der SQL-Datenbank an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe für den SQL-Datenbankserver an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ServerName

Gibt den Namen des SQL-Datenbankservers an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SqlServerResourceIdForPrivateLink

Die SQL Server-Ressourcen-ID zum Erstellen eines privaten Links

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StorageAccountResourceIdForPrivateLink

Die Ressourcen-ID des Speicherkontos zum Erstellen eines privaten Links

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StorageKey

Gibt den Zugriffsschlüssel für das Speicherkonto an.

Wenn -StorageKeyType ManagedIdentity angegeben, sollte dies die vollständige Ressourcen-ID einer vom Benutzer zugewiesenen verwalteten Identität sein, die Schreibzugriff auf das Speicherkonto für den bereitgestellten StorageUri hat (z. B. über eine Rollenzuweisung von Storage Blob Data Contributor ).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StorageKeyType

Gibt den Zugriffsschlüsseltyp für das Speicherkonto an. Die zulässigen Werte für diesen Parameter sind:

  • StorageAccessKey. Dieser Wert verwendet einen Speicherkontoschlüssel.
  • SharedAccessKey. Dieser Wert verwendet einen SAS-Schlüssel (Shared Access Signature).
  • ManagedIdentity. Verwenden Sie eine vom Benutzer zugewiesene verwaltete Identität für die Authentifizierung mit dem Speicherkonto.

Parametereigenschaften

Typ:StorageKeyType
Standardwert:None
Zulässige Werte:StorageAccessKey, SharedAccessKey, ManagedIdentity
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StorageUri

Das Cmdlet New-AzSqlDatabaseExport exportiert eine Azure SQL-Datenbank als BACPAC-Datei in ein Speicherkonto. Die Anforderung zum Abrufen des Exportdatenbankstatus kann gesendet werden, um Statusinformationen für diese Anforderung abzurufen. Dieses Cmdlet wird auch vom SQL Server Stretch Database Dienst auf Azure unterstützt.

Von Bedeutung

Um dieses Cmdlet nutzen zu können, muss die Firewall auf der Azure SQL Server so konfiguriert werden, dass "Azure Dienste und Ressourcen für den Zugriff auf diesen Server zulassen" konfiguriert werden. Wenn dies nicht konfiguriert ist, werden GatewayTimeout-Fehler auftreten. Dies ist nicht erforderlich, wenn über den Parameter UseNetworkIsolation eine Private Link Verbindung hergestellt wird.

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UseNetworkIsolation

Wenn festgelegt, wird eine private Verknüpfung für Speicherkonto und/oder SQL Server erstellt.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Ausgaben

AzureSqlDatabaseImportExportBaseModel

Hinweise

  • Schlüsselwörter: azure, azurerm, arm, resource, management, manager, sql, database, mssql