Restore-AzureRmSqlDatabase

Moduł:

AzureRM.Sql

Przywraca bazę danych SQL.

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Restore-AzureRmSqlDatabase przywraca bazę danych SQL z geograficznie nadmiarowej kopii zapasowej, kopię zapasową usuniętej bazy danych, długoterminową kopię zapasową przechowywania lub punkt w czasie w aktywnej bazie danych. Przywrócona baza danych jest tworzona jako nowa baza danych. Elastyczną bazę danych SQL można utworzyć, ustawiając parametr ElasticPoolName na istniejącą elastyczną pulę.

Przykłady

Przykład 1. Przywracanie bazy danych z punktu w czasie

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"

Pierwsze polecenie pobiera bazę danych SQL o nazwie Database01, a następnie zapisuje ją w zmiennej $Database. Drugie polecenie przywraca bazę danych w $Database z określonej kopii zapasowej do bazy danych o nazwie RestoreDatabase.

Przykład 2. Przywracanie bazy danych z punktu w czasie do elastycznej puli

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"

Pierwsze polecenie pobiera bazę danych SQL o nazwie Database01, a następnie zapisuje ją w zmiennej $Database. Drugie polecenie przywraca bazę danych w $Database z określonej kopii zapasowej punktu w czasie do bazy danych SQL o nazwie RestoreDatabase w elastycznej puli o nazwie elasticpool01.

Przykład 3. Przywracanie usuniętej bazy danych

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

Pierwsze polecenie pobiera usuniętą kopię zapasową bazy danych, którą chcesz przywrócić przy użyciu polecenia Get-AzureRmSqlDeletedDatabaseBackup. Drugie polecenie uruchamia przywracanie z usuniętej kopii zapasowej bazy danych przy użyciu polecenia cmdlet Restore-AzureRmSqlDatabase . Jeśli parametr -PointInTime nie zostanie określony, baza danych zostanie przywrócona do czasu usunięcia.

Przykład 4. Przywracanie usuniętej bazy danych do elastycznej puli

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

Pierwsze polecenie pobiera usuniętą kopię zapasową bazy danych, którą chcesz przywrócić przy użyciu polecenia Get-AzureRmSqlDeletedDatabaseBackup. Drugie polecenie uruchamia przywracanie z usuniętej kopii zapasowej bazy danych przy użyciu polecenia Restore-AzureRmSqlDatabase. Jeśli parametr -PointInTime nie zostanie określony, baza danych zostanie przywrócona do czasu usunięcia.

Przykład 5. Przywracanie geograficzne bazy danych

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"

Pierwsze polecenie pobiera geograficznie nadmiarową kopię zapasową bazy danych o nazwie Database01, a następnie zapisuje ją w zmiennej $GeoBackup. Drugie polecenie przywraca kopię zapasową w $GeoBackup do bazy danych SQL o nazwie RestoreDatabase.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

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

-ComputeGeneration

Generowanie zasobów obliczeniowych do przypisania do przywróconej bazy danych

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

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

-DeletionDate

Określa datę usunięcia jako obiekt DateTime . Aby uzyskać obiekt DateTime , użyj polecenia cmdlet Get-Date.

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

-Edition

Określa edycję bazy danych SQL. Dopuszczalne wartości tego parametru to:

• Brak
• Podstawowa
• Standardowa (Standard)
• Premium
• DataWarehouse
• Bezpłatna
• Stretch
• Ogólnego przeznaczenia
• BusinessCritical

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

-ElasticPoolName

Określa nazwę elastycznej puli, w której ma być umieszczona baza danych SQL.

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

-FromDeletedDatabaseBackup

Wskazuje, że to polecenie cmdlet przywraca bazę danych z kopii zapasowej usuniętej bazy danych SQL. Aby uzyskać kopię zapasową usuniętej bazy danych SQL, możesz użyć polecenia cmdlet Get-AzureRMSqlDeletedDatabaseBackup.

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

-FromGeoBackup

Wskazuje, że to polecenie cmdlet przywraca bazę danych SQL z geograficznie nadmiarowej kopii zapasowej. Aby uzyskać geograficznie nadmiarową kopię zapasową, możesz użyć polecenia cmdlet Get-AzureRMSqlDatabaseGeoBackup.

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

-FromLongTermRetentionBackup

Wskazuje, że to polecenie cmdlet przywraca bazę danych SQL z kopii zapasowej długoterminowego przechowywania.

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

-FromPointInTimeBackup

Wskazuje, że to polecenie cmdlet przywraca bazę danych SQL z kopii zapasowej do punktu w czasie.

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

-LicenseType

Typ licencji dla bazy danych Azure Sql Database.

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

-PointInTime

Określa punkt w czasie, jako obiekt DateTime , do którego chcesz przywrócić bazę danych SQL. Aby uzyskać obiekt DateTime , użyj polecenia cmdlet Get-Date . Użyj tego parametru razem z parametrem FromPointInTimeBackup .

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

-ResourceGroupName

Określa nazwę grupy zasobów, do której to polecenie cmdlet przypisuje bazę danych SQL.

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

-ResourceId

Określa identyfikator zasobu do przywrócenia.

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

-ServerName

Określa nazwę serwera bazy danych SQL.

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

-ServiceObjectiveName

Określa nazwę celu usługi.

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

-TargetDatabaseName

Określa nazwę bazy danych do przywrócenia.

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

-VCore

Liczby rdzeni wirtualnych przywróconej usługi Azure Sql Database.

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

Dane wejściowe

DateTime

String

Dane wyjściowe

AzureSqlDatabaseModel

Linki powiązane

• Odzyskiwanie bazy danych Azure SQL Database z awarii
• Odzyskiwanie bazy danych Azure SQL Database z powodu błędu użytkownika
• Get-AzureRmSqlDatabase
• Get-AzureRMSqlDatabaseGeoBackup
• Get-AzureRMSqlDeletedDatabaseBackup
• Dokumentacja usługi SQL Database