Restore-AzSqlDatabase

Başvuru

Modül:: Az.Sql

SQL veritabanını geri yükler.

Sözdizimi

Restore-AzSqlDatabase
       [-FromPointInTimeBackup]
       -PointInTime <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-HAReplicaCount <Int32>]
       [-BackupStorageRedundancy <String>]
       [-ZoneRedundant]
       [-Tag <Hashtable>]
       [-AssignIdentity]
       [-EncryptionProtector <String>]
       [-UserAssignedIdentityId <String[]>]
       [-KeyList <String[]>]
       [-FederatedClientId <Guid>]
       [-EncryptionProtectorAutoRotation]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzSqlDatabase
       [-FromPointInTimeBackup]
       -PointInTime <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-HAReplicaCount <Int32>]
       [-BackupStorageRedundancy <String>]
       [-ZoneRedundant]
       [-Tag <Hashtable>]
       [-AssignIdentity]
       [-EncryptionProtector <String>]
       [-UserAssignedIdentityId <String[]>]
       [-KeyList <String[]>]
       [-FederatedClientId <Guid>]
       [-EncryptionProtectorAutoRotation]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzSqlDatabase
       [-FromDeletedDatabaseBackup]
       [-PointInTime <DateTime>]
       -DeletionDate <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-HAReplicaCount <Int32>]
       [-BackupStorageRedundancy <String>]
       [-ZoneRedundant]
       [-Tag <Hashtable>]
       [-AssignIdentity]
       [-EncryptionProtector <String>]
       [-UserAssignedIdentityId <String[]>]
       [-KeyList <String[]>]
       [-FederatedClientId <Guid>]
       [-EncryptionProtectorAutoRotation]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzSqlDatabase
       [-FromDeletedDatabaseBackup]
       [-PointInTime <DateTime>]
       -DeletionDate <DateTime>
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-HAReplicaCount <Int32>]
       [-BackupStorageRedundancy <String>]
       [-ZoneRedundant]
       [-Tag <Hashtable>]
       [-AssignIdentity]
       [-EncryptionProtector <String>]
       [-UserAssignedIdentityId <String[]>]
       [-KeyList <String[]>]
       [-FederatedClientId <Guid>]
       [-EncryptionProtectorAutoRotation]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzSqlDatabase
       [-FromGeoBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-HAReplicaCount <Int32>]
       [-BackupStorageRedundancy <String>]
       [-ZoneRedundant]
       [-Tag <Hashtable>]
       [-AssignIdentity]
       [-EncryptionProtector <String>]
       [-UserAssignedIdentityId <String[]>]
       [-KeyList <String[]>]
       [-FederatedClientId <Guid>]
       [-EncryptionProtectorAutoRotation]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzSqlDatabase
       [-FromGeoBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-HAReplicaCount <Int32>]
       [-BackupStorageRedundancy <String>]
       [-ZoneRedundant]
       [-Tag <Hashtable>]
       [-AssignIdentity]
       [-EncryptionProtector <String>]
       [-UserAssignedIdentityId <String[]>]
       [-KeyList <String[]>]
       [-FederatedClientId <Guid>]
       [-EncryptionProtectorAutoRotation]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzSqlDatabase
       [-FromLongTermRetentionBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       [-Edition <String>]
       [-ServiceObjectiveName <String>]
       [-ElasticPoolName <String>]
       [-AsJob]
       [-LicenseType <String>]
       [-HAReplicaCount <Int32>]
       [-BackupStorageRedundancy <String>]
       [-ZoneRedundant]
       [-Tag <Hashtable>]
       [-AssignIdentity]
       [-EncryptionProtector <String>]
       [-UserAssignedIdentityId <String[]>]
       [-KeyList <String[]>]
       [-FederatedClientId <Guid>]
       [-EncryptionProtectorAutoRotation]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzSqlDatabase
       [-FromLongTermRetentionBackup]
       -ResourceId <String>
       -ServerName <String>
       -TargetDatabaseName <String>
       -Edition <String>
       [-AsJob]
       -ComputeGeneration <String>
       -VCore <Int32>
       [-LicenseType <String>]
       [-HAReplicaCount <Int32>]
       [-BackupStorageRedundancy <String>]
       [-ZoneRedundant]
       [-Tag <Hashtable>]
       [-AssignIdentity]
       [-EncryptionProtector <String>]
       [-UserAssignedIdentityId <String[]>]
       [-KeyList <String[]>]
       [-FederatedClientId <Guid>]
       [-EncryptionProtectorAutoRotation]
       [-ResourceGroupName] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Restore-AzSqlDatabase cmdlet'i bir SQL veritabanını coğrafi olarak yedekli bir yedeklemeden, silinen bir veritabanının yedeğinden, uzun süreli saklama yedeklemesinden veya canlı veritabanındaki belirli bir noktadan geri yükler. Geri yüklenen veritabanı yeni bir veritabanı olarak oluşturulur. ElasticPoolName parametresini mevcut bir elastik havuza ayarlayarak elastik bir SQL veritabanı oluşturabilirsiniz. Veri deposu veritabanı için abonelikler arası geri yükleme de gerçekleştirebilirsiniz.

Örnekler

Örnek 1: Veritabanını belirli bir noktadan geri yükleme

$Database = Get-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
Restore-AzSqlDatabase -FromPointInTimeBackup -PointInTime UTCDateTime -ResourceGroupName $Database.ResourceGroupName -ServerName $Database.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $Database.ResourceID -Edition "Standard" -ServiceObjectiveName "S2"

İlk komut Database01 adlı SQL veritabanını alır ve $Database değişkeninde depolar. İkinci komut, $Database veritabanını belirtilen belirli bir noktaya yedeklemeden RestoredDatabase adlı veritabanına geri yükler.

Örnek 2: Veritabanını belirli bir noktadan elastik havuza geri yükleme

$Database = Get-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
Restore-AzSqlDatabase -FromPointInTimeBackup -PointInTime UTCDateTime -ResourceGroupName $Database.ResourceGroupName -ServerName $Database.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $Database.ResourceID -ElasticPoolName "ElasticPool01"

İlk komut Database01 adlı SQL veritabanını alır ve $Database değişkeninde depolar. İkinci komut, $Database veritabanını belirtilen belirli bir noktaya yedeklemeden elasticpool01 adlı elastik havuzdaki RestoredDatabase adlı SQL veritabanına geri yükler.

Örnek 3: Silinen veritabanını geri yükleme

$DeletedDatabase = Get-AzSqlDeletedDatabaseBackup -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
Restore-AzSqlDatabase -FromDeletedDatabaseBackup -DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $DeletedDatabase.ResourceGroupName -ServerName $DeletedDatabase.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $DeletedDatabase.ResourceID -Edition "Standard" -ServiceObjectiveName "S2" -PointInTime UTCDateTime

İlk komut, Get-AzSqlDeletedDatabaseBackup kullanarak geri yüklemek istediğiniz silinen veritabanı yedeğini alır. İkinci komut, Restore-AzSqlDatabase cmdlet'ini kullanarak silinen veritabanı yedeklemesinden geri yüklemeyi başlatır. -PointInTime parametresi belirtilmezse, veritabanı silinme zamanına geri yüklenir.

Örnek 4: Silinen veritabanını elastik havuza geri yükleme

$DeletedDatabase = Get-AzSqlDeletedDatabaseBackup -ResourceGroupName $resourceGroupName -ServerName $sqlServerName -DatabaseName 'DatabaseToRestore'
Restore-AzSqlDatabase -FromDeletedDatabaseBackup -DeletionDate $DeletedDatabase.DeletionDate -ResourceGroupName $DeletedDatabase.ResourceGroupName -ServerName $DeletedDatabase.ServerName -TargetDatabaseName "RestoredDatabase" -ResourceId $DeletedDatabase.ResourceID -ElasticPoolName "elasticpool01" -PointInTime UTCDateTime

İlk komut, Get-AzSqlDeletedDatabaseBackup kullanarak geri yüklemek istediğiniz silinen veritabanı yedeğini alır. İkinci komut, Restore-AzSqlDatabase kullanarak silinen veritabanı yedeklemesinden geri yüklemeyi başlatır. -PointInTime parametresi belirtilmezse, veritabanı silinme zamanına geri yüklenir.

Örnek 5: Veritabanını coğrafi olarak geri yükleme

$GeoBackup = Get-AzSqlDatabaseGeoBackup -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
Restore-AzSqlDatabase -FromGeoBackup -ResourceGroupName "TargetResourceGroup" -ServerName "TargetServer" -TargetDatabaseName "RestoredDatabase" -ResourceId $GeoBackup.ResourceID -Edition "Standard" -ServiceObjectiveName "S2"

İlk komut Database01 adlı veritabanı için coğrafi olarak yedekli yedeklemeyi alır ve $GeoBackup değişkeninde depolar. İkinci komut, $GeoBackup içindeki yedeklemeyi RestoredDatabase adlı SQL veritabanına geri yükler.

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırma

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-AssignIdentity

Azure KeyVault gibi anahtar yönetimi hizmetleriyle kullanmak üzere bu veritabanı için bir Microsoft Entra kimliği oluşturun ve atayın.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-BackupStorageRedundancy

SQL Veritabanı yedeklemelerini depolamak için kullanılan Yedekleme depolama yedekliliği. Seçenekler şunlardır: Yerel, Bölge, Coğrafi ve Coğrafi Bölge.

Tür:	String
Kabul edilen değerler:	Local, Zone, Geo, GeoZone
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ComputeGeneration

Geri yüklenen veritabanına atanacak işlem oluşturma

Tür:	String
Diğer adlar:	Family
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Tür:	IAzureContextContainer
Diğer adlar:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DeletionDate

Silme tarihini DateTime nesnesi olarak belirtir. DateTime nesnesi almak için Get-Date cmdlet'ini kullanın.

Tür:	DateTime
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Edition

SQL veritabanının sürümünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

Hiçbiri
Temel
Standart
Premium
DataWarehouse
Ücretsiz
Uzat
GeneralPurpose
businesscritical

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ElasticPoolName

SQL veritabanının yerleştirildiği elastik havuzun adını belirtir.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-EncryptionProtector

SQL Veritabanı için şifreleme koruyucu anahtarı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-EncryptionProtectorAutoRotation

AKV Anahtarı Otomatik Döndürme durumu

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-FederatedClientId

SQL Veritabanı için federasyon istemci kimliği. Kiracılar arası CMK senaryosu için kullanılır.

Tür:	Nullable<T>[Guid]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-FromDeletedDatabaseBackup

Bu cmdlet'in silinen sql veritabanının yedeğinden bir veritabanını geri yüklediğini gösterir. Silinen sql veritabanının yedeğini almak için Get-AzSqlDeletedDatabaseBackup cmdlet'ini kullanabilirsiniz.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-FromGeoBackup

Bu cmdlet'in coğrafi olarak yedekli bir yedeklemeden sql veritabanını geri yüklediğini gösterir. Coğrafi olarak yedekli yedekleme almak için Get-AzSqlDatabaseGeoBackup cmdlet'ini kullanabilirsiniz.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-FromLongTermRetentionBackup

Bu cmdlet'in sql veritabanını uzun süreli saklama yedeğinden geri yüklediğini gösterir.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-FromPointInTimeBackup

Bu cmdlet'in bir SQL veritabanını belirli bir noktaya yedeklemeden geri yüklediğini gösterir.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-HAReplicaCount

SQL Veritabanı yedeklerini depolamak için kullanılan HA Çoğaltma Sayısı.

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-KeyList

SQL Veritabanı için AKV anahtarlarının listesi.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-LicenseType

Azure Sql veritabanının lisans türü.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-PointInTime

SQL veritabanınızı geri yüklemek istediğiniz bir DateTime nesnesi olarak zaman noktasını belirtir. DateTime nesnesi almak için Get-Date cmdlet'ini kullanın. Bu parametreyi FromPointInTimeBackup parametresiyle birlikte kullanın.

Tür:	DateTime
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ResourceGroupName

Bu cmdlet'in SQL veritabanını atadığı kaynak grubunun adını belirtir.

Tür:	String
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-ResourceId

Geri yükleneceği kaynağın kimliğini belirtir.

Tür:	String
Diğer adlar:	Id
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-ServerName

SQL veritabanı sunucusunun adını belirtir.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-ServiceObjectiveName

Hizmet hedefinin adını belirtir.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Tag

Azure Sql Veritabanı ile ilişkilendirilecek etiketler

Tür:	Hashtable
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-TargetDatabaseName

Geri yükleneceği veritabanının adını belirtir.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-UserAssignedIdentityId

SQL Veritabanı için kullanıcı tarafından atanan kimliğin listesi.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-VCore

Geri yüklenen Azure Sql Veritabanı'nın sanal çekirdek numaraları.

Tür:	Int32
Diğer adlar:	Capacity
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ZoneRedundant

Azure Sql Veritabanı ile ilişkilendirilecek bölge yedekliliği. Bu özellik yalnızca Hiper Ölçek sürümü veritabanları için ayarlanabilir.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

DateTime

String

Çıkışlar

AzureSqlDatabaseModel

Aracılığıyla paylaş