Share via

Restore-AzureRmSqlDatabase

  • Referenz
Modul:
AzureRM.Sql

Stellt eine SQL-Datenbank wieder her.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Restore-AzureRmSqlDatabase
       [-FromPointInTimeBackup]
       -PointInTime <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromPointInTimeBackup]
       -PointInTime <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromDeletedDatabaseBackup]
       [-PointInTime <DateTime>]
       -DeletionDate <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromDeletedDatabaseBackup]
       [-PointInTime <DateTime>]
       -DeletionDate <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromGeoBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromGeoBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromLongTermRetentionBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Restore-AzureRmSqlDatabase
       [-FromLongTermRetentionBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]

Beschreibung

Das Cmdlet Restore-AzureRmSqlDatabase stellt eine SQL-Datenbank aus einer georedundanten Sicherung, einer Sicherung einer gelöschten Datenbank, einer langfristigen Aufbewahrungssicherung oder einem Zeitpunkt in einer Livedatenbank wieder her. Die wiederhergestellte Datenbank wird als neue Datenbank erstellt. Sie können eine elastische SQL-Datenbank erstellen, indem Sie den ElasticPoolName-Parameter auf einen vorhandenen elastischen Pool festlegen.

Beispiele

Beispiel 1: Wiederherstellen einer Datenbank von einem Zeitpunkt an

PS C:\>$Database = Get-AzureRmSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
PS C:\> Restore-AzureRmSqlDatabase -FromPointInTimeBackup -PointInTime UTCDateTime -ResourceGroupName $Database.ResourceGroupName -ServerName $Database.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $Database.ResourceID -Edition "Standard" -ServiceObjectiveName "S2"

Der erste Befehl ruft die SQL-Datenbank mit dem Namen "Database01" ab und speichert sie dann in der variablen $Database. Mit dem zweiten Befehl wird die Datenbank in $Database aus der angegebenen Point-in-Time-Sicherung in der Datenbank namens "RestoredDatabase" wiederhergestellt.

Beispiel 2: Wiederherstellen einer Datenbank von einem Zeitpunkt zu einem elastischen Pool

PS C:\>$Database = Get-AzureRmSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
PS C:\> Restore-AzureRmSqlDatabase -FromPointInTimeBackup -PointInTime UTCDateTime -ResourceGroupName $Database.ResourceGroupName -ServerName $Database.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $Database.ResourceID -ElasticPoolName "ElasticPool01"

Der erste Befehl ruft die SQL-Datenbank mit dem Namen "Database01" ab und speichert sie dann in der variablen $Database. Mit dem zweiten Befehl wird die Datenbank in $Database aus der angegebenen Point-in-Time-Sicherung in der SQL-Datenbank namens "RestoredDatabase" im elastischen Pool namens elasticpool01 wiederhergestellt.

Beispiel 3: Wiederherstellen einer gelöschten Datenbank

PS C:\>$DeletedDatabase = Get-AzureRmSqlDeletedDatabaseBackup -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
PS C:\> Restore-AzureRmSqlDatabase -FromDeletedDatabaseBackup -DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $DeletedDatabase.ResourceGroupName -ServerName $DeletedDatabase.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $DeletedDatabase.ResourceID -Edition "Standard" -ServiceObjectiveName "S2" -PointInTime UTCDateTime

Der erste Befehl ruft die gelöschte Datenbanksicherung ab, die Sie mithilfe von Get-AzureRmSqlDeletedDatabaseBackup wiederherstellen möchten. Der zweite Befehl startet die Wiederherstellung aus der gelöschten Datenbanksicherung mithilfe des Cmdlets Restore-AzureRmSqlDatabase . Wenn der Parameter "-PointInTime" nicht angegeben ist, wird die Datenbank zur Löschzeit wiederhergestellt.

Beispiel 4: Wiederherstellen einer gelöschten Datenbank in einem elastischen Pool

PS C:\>$DeletedDatabase = Get-AzureRmSqlDeletedDatabaseBackup -ResourceGroupName $resourceGroupName -ServerName $sqlServerName -DatabaseName 'DatabaseToRestore'
PS C:\> Restore-AzureRmSqlDatabase -FromDeletedDatabaseBackup -DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $DeletedDatabase.ResourceGroupName -ServerName $DeletedDatabase.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $DeletedDatabase.ResourceID -ElasticPoolName "elasticpool01" -PointInTime UTCDateTime

Der erste Befehl ruft die gelöschte Datenbanksicherung ab, die Sie mithilfe von Get-AzureRmSqlDeletedDatabaseBackup wiederherstellen möchten. Der zweite Befehl startet die Wiederherstellung aus der gelöschten Datenbanksicherung mithilfe von Restore-AzureRmSqlDatabase. Wenn der Parameter "-PointInTime" nicht angegeben ist, wird die Datenbank zur Löschzeit wiederhergestellt.

Beispiel 5: Geo-Wiederherstellen einer Datenbank

PS C:\>$GeoBackup = Get-AzureRmSqlDatabaseGeoBackup -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
PS C:\> Restore-AzureRmSqlDatabase -FromGeoBackup -ResourceGroupName "TargetResourceGroup" -ServerName "TargetServer" -TargetDatabaseName "RestoredDatabase" -ResourceId $GeoBackup.ResourceID -Edition "Standard" -RequestedServiceObjectiveName "S2"

Der erste Befehl ruft die georedundante Sicherung für die Datenbank namens "Database01" ab und speichert sie dann in der variablen $GeoBackup. Mit dem zweiten Befehl wird die Sicherung in $GeoBackup in der SQL-Datenbank namens "RestoredDatabase" wiederhergestellt.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputeGeneration

Die Berechnungsgenerierung, die der wiederhergestellten Datenbank zugewiesen werden soll

Type:String
Aliases:Family
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeletionDate

Gibt das Löschdatum als DateTime-Objekt an. Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet "Get-Date".

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Edition

Gibt die Edition der SQL-Datenbank an. Zulässige Werte für diesen Parameter:

  • Keine
  • Basic
  • Standard
  • Premium
  • DataWarehouse
  • Kostenlos
  • Ziehen
  • Universell
  • BusinessCritical
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

Gibt den Namen des elastischen Pools an, in dem die SQL-Datenbank abgelegt werden soll.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-FromDeletedDatabaseBackup

Gibt an, dass dieses Cmdlet eine Datenbank aus einer Sicherung einer gelöschten SQL-Datenbank wiederherstellen kann. Sie können das Cmdlet Get-AzureRMSqlDeletedDatabaseBackup verwenden, um die Sicherung einer gelöschten SQL-Datenbank abzurufen.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FromGeoBackup

Gibt an, dass dieses Cmdlet eine SQL-Datenbank aus einer georedundanten Sicherung wiederherstellen kann. Sie können das Cmdlet Get-AzureRMSqlDatabaseGeoBackup verwenden, um eine georedundante Sicherung abzurufen.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FromLongTermRetentionBackup

Gibt an, dass dieses Cmdlet eine SQL-Datenbank aus einer langfristigen Aufbewahrungssicherung wiederherstellen kann.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FromPointInTimeBackup

Gibt an, dass dieses Cmdlet eine SQL-Datenbank aus einer Point-in-Time-Sicherung wiederhergestellt.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LicenseType

Der Lizenztyp für die Azure SQL-Datenbank.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PointInTime

Gibt den Zeitpunkt als DateTime-Objekt an, in dem Sie die SQL-Datenbank wiederherstellen möchten. Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet "Get-Date". Verwenden Sie diesen Parameter zusammen mit dem Parameter FromPointInTimeBackup .

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, der dieses Cmdlet die SQL-Datenbank zuweist.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Gibt die ID der wiederherzustellenden Ressource an.

Type:String
Aliases:Id
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

Gibt den Namen des SQL-Datenbankservers an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServiceObjectiveName

Gibt den Namen des Dienstziels an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TargetDatabaseName

Gibt den Namen der Datenbank an, auf die wiederhergestellt werden soll.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VCore

Die Vcore-Nummern der wiederhergestellten Azure SQL-Datenbank.

Type:Int32
Aliases:Capacity
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

DateTime

String

Ausgaben

AzureSqlDatabaseModel