New-AzSqlDatabaseImport

Modul:

Az.Sql Module

Importiert eine BACPAC-Datei und erstellt eine neue Datenbank auf dem Server.

Syntax

Default (Standard)

New-AzSqlDatabaseImport
    -DatabaseName <String>
    -Edition <DatabaseEdition>
    -ServiceObjectiveName <String>
    -DatabaseMaxSizeBytes <Int64>
    [-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-AzSqlDatabaseImport importiert eine Bacpac-Datei aus einem Azure-Speicherkonto in eine neue Azure SQL-Datenbank. Die Anforderung zum Abrufen des Importdatenbankstatus kann gesendet werden, um Statusinformationen für diese Anforderung abzurufen.

Beispiele

Beispiel 1: Erstellen einer Importanforderung für eine Bacpac-Datei

New-AzSqlDatabaseImport -ResourceGroupName "RG01" -ServerName "Server01" -DatabaseName "Database01" -StorageKeyType "StorageAccessKey" -StorageKey "StorageKey01" -StorageUri "http://account01.blob.core.contoso.net/bacpacs/database01.bacpac" -AdministratorLogin "User" -AdministratorLoginPassword $SecureString -Edition Standard -ServiceObjectiveName S0 -DatabaseMaxSizeBytes 5000000

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.contoso.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 Importanforderung erstellt, um eine BACPAC-Datei in eine neue Datenbank zu importieren.

Beispiel 2

Importiert eine BACPAC-Datei und erstellt eine neue Datenbank auf dem Server. (autogenerated)

New-AzSqlDatabaseImport -AdministratorLogin 'User' -AdministratorLoginPassword <SecureString> -AuthenticationType None -DatabaseMaxSizeBytes 5000000 -DatabaseName 'Database01' -Edition None -ResourceGroupName 'RG01' -ServerName 'Server01' -ServiceObjectiveName S0 -StorageKey 'StorageKey01' -StorageKeyType StorageAccessKey -StorageUri 'https://account01.blob.core.contoso.net/bacpacs/database01.bacpac'

Parameter

-AdministratorLogin

Gibt den Namen des SQL-Administrators an.

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. Dieser Parameter ist standardmäßig sql, wenn kein Authentifizierungstyp festgelegt ist. Die zulässigen Werte für diesen Parameter sind:

• SQL. SQL-Authentifizierung. Legen Sie die Parameter "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.

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:	vgl

Parametersätze

(All)

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

-DatabaseMaxSizeBytes

Gibt die maximale Größe für die neu importierte Datenbank an.

Parametereigenschaften

Typ:	Int64
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

-DatabaseName

Gibt den Namen der SQL-Datenbank an.

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

-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

-Edition

Gibt die Edition der neuen Datenbank an, in die importiert werden soll. Die zulässigen Werte für diesen Parameter sind:

• Premium
• Basic
• Norm
• DataWarehouse
• Kostenlos

Parametereigenschaften

Typ:	DatabaseEdition
Standardwert:	None
Zulässige Werte:	None, Premium, Basic, Standard, DataWarehouse, Stretch, Free, PremiumRS, GeneralPurpose, BusinessCritical, Hyperscale
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

-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

-ServiceObjectiveName

Gibt den Namen des Dienstziels an, das der Azure SQL-Datenbank zugewiesen werden soll.

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

-SqlServerResourceIdForPrivateLink

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

Parametereigenschaften

Typ:	String
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

-StorageAccountResourceIdForPrivateLink

Die Ressourcen-ID des Speicherkontos zum Erstellen eines privaten Links

Parametereigenschaften

Typ:	String
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

-StorageKey

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

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. Verwendet den Speicherkontoschlüssel.
• SharedAccessKey. Verwendet den SAS-Schlüssel (Shared Access Signature).

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

Gibt den BLOB-URI der BACPAC-Datei an.

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

Ähnliche Themen

• Get-AzSqlDatabaseImportExportStatus
• New-AzSqlDatabaseExport
• SQL-Datenbankdokumentation