Restore-AzureRmSqlDatabase

모듈:

AzureRM.Sql

SQL 데이터베이스를 복원합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

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

Description

Restore-AzureRmSqlDatabase cmdlet은 지역 중복 백업, 삭제된 데이터베이스 백업, 장기 보존 백업 또는 라이브 데이터베이스의 특정 시점에서 SQL 데이터베이스를 복원합니다. 복원된 데이터베이스는 새 데이터베이스로 만들어집니다. ElasticPoolName 매개 변수를 기존 탄력적 풀로 설정하여 탄력적 SQL 데이터베이스를 만들 수 있습니다.

예제

예제 1: 특정 시점부터 데이터베이스 복원

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"

첫 번째 명령은 Database01이라는 SQL 데이터베이스를 가져오고 $Database 변수에 저장합니다. 두 번째 명령은 지정된 지정 시간 백업에서 RestoreedDatabase라는 데이터베이스로 $Database 데이터베이스를 복원합니다.

예제 2: 특정 시점의 데이터베이스를 탄력적 풀로 복원

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"

첫 번째 명령은 Database01이라는 SQL 데이터베이스를 가져오고 $Database 변수에 저장합니다. 두 번째 명령은 지정된 지정 시간 백업에서 elasticpool01이라는 탄력적 풀의 RestoredDatabase라는 SQL 데이터베이스로 $Database 데이터베이스를 복원합니다.

예제 3: 삭제된 데이터베이스 복원

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

첫 번째 명령은 Get-AzureRmSqlDeletedDatabaseBackup을 사용하여 복원하려는 삭제된 데이터베이스 백업을 가져옵니다. 두 번째 명령은 Restore-AzureRmSqlDatabase cmdlet을 사용하여 삭제된 데이터베이스 백업에서 복원을 시작합니다. -PointInTime 매개 변수를 지정하지 않으면 데이터베이스가 삭제 시간으로 복원됩니다.

예제 4: 삭제된 데이터베이스를 탄력적 풀로 복원

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

첫 번째 명령은 Get-AzureRmSqlDeletedDatabaseBackup을 사용하여 복원하려는 삭제된 데이터베이스 백업을 가져옵니다. 두 번째 명령은 Restore-AzureRmSqlDatabase를 사용하여 삭제된 데이터베이스 백업에서 복원을 시작합니다. -PointInTime 매개 변수를 지정하지 않으면 데이터베이스가 삭제 시간으로 복원됩니다.

예제 5: 데이터베이스 지역 복원

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"

첫 번째 명령은 Database01이라는 데이터베이스에 대한 지역 중복 백업을 가져오고 $GeoBackup 변수에 저장합니다. 두 번째 명령은 $GeoBackup 백업을 RestoredDatabase라는 SQL 데이터베이스로 복원합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ComputeGeneration

복원된 데이터베이스에 할당할 컴퓨팅 생성

형식:	String
별칭:	Family
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:	IAzureContextContainer
별칭:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeletionDate

삭제 날짜를 DateTime 개체로 지정합니다. DateTime 개체를 얻으려면 Get-Date cmdlet을 사용합니다.

형식:	DateTime
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Edition

SQL 데이터베이스의 버전을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• None
• Basic
• Standard
• Premium
• DataWarehouse
• Free
• Stretch
• GeneralPurpose
• BusinessCritical

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ElasticPoolName

SQL 데이터베이스를 배치할 탄력적 풀의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-FromDeletedDatabaseBackup

이 cmdlet은 삭제된 SQL 데이터베이스의 백업에서 데이터베이스를 복원한다는 것을 나타냅니다. Get-AzureRMSqlDeletedDatabaseBackup cmdlet을 사용하여 삭제된 SQL 데이터베이스의 백업을 가져올 수 있습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FromGeoBackup

이 cmdlet은 지역 중복 백업에서 SQL 데이터베이스를 복원한다는 것을 나타냅니다. Get-AzureRMSqlDatabaseGeoBackup cmdlet을 사용하여 지역 중복 백업을 가져올 수 있습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FromLongTermRetentionBackup

이 cmdlet은 장기 보존 백업에서 SQL 데이터베이스를 복원한다는 것을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FromPointInTimeBackup

이 cmdlet은 지정 시간 백업에서 SQL 데이터베이스를 복원한다는 것을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-LicenseType

Azure Sql 데이터베이스의 라이선스 유형입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PointInTime

SQL 데이터베이스를 복원하려는 특정 시점을 DateTime 개체로 지정합니다. DateTime 개체를 얻으려면 Get-Date cmdlet을 사용합니다. FromPointInTimeBackup 매개 변수와 함께 이 매개 변수를 사용합니다.

형식:	DateTime
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

이 cmdlet이 SQL 데이터베이스를 할당하는 리소스 그룹의 이름을 지정합니다.

형식:	String
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ResourceId

복원할 리소스의 ID를 지정합니다.

형식:	String
별칭:	Id
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ServerName

SQL 데이터베이스 서버의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ServiceObjectiveName

서비스 목표의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-TargetDatabaseName

복원할 데이터베이스의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-VCore

복원된 Azure Sql Database의 Vcore 번호입니다.

형식:	Int32
별칭:	Capacity
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

DateTime

String

출력

AzureSqlDatabaseModel

관련 링크

• 중단에서 Azure SQL Database 복구
• 사용자 오류에서 Azure SQL Database 복구
• Get-AzureRmSqlDatabase
• Get-AzureRMSqlDatabaseGeoBackup
• Get-AzureRMSqlDeletedDatabaseBackup
• SQL Database 설명서