Restore-AzureRmSqlDatabase

Référence

Module:: AzureRM.Sql

Restaure une base de données SQL.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

L’applet de commande Restore-AzureRmSqlDatabase restaure une base de données SQL à partir d’une sauvegarde géoredondante, d’une sauvegarde d’une base de données supprimée, d’une sauvegarde de rétention à long terme ou d’un point dans le temps dans une base de données dynamique. La base de données restaurée est créée en tant que nouvelle base de données. Vous pouvez créer une base de données SQL élastique en définissant le paramètre ElasticPoolName sur un pool élastique existant.

Exemples

Exemple 1 : Restaurer une base de données à partir d’un point dans le temps

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"

La première commande obtient la base de données SQL nommée Database01, puis la stocke dans la variable $Database. La deuxième commande restaure la base de données dans $Database à partir de la sauvegarde à un point dans le temps spécifié dans la base de données nommée RestoreDatabase.

Exemple 2 : Restaurer une base de données d’un point dans le temps vers un pool élastique

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"

Exemple 3 : Restaurer une base de données supprimée

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

La première commande obtient la sauvegarde de base de données supprimée que vous souhaitez restaurer à l’aide de Get-AzureRmSqlDeletedDatabaseBackup. La deuxième commande démarre la restauration à partir de la sauvegarde de base de données supprimée à l’aide de l’applet de commande Restore-AzureRmSqlDatabase . Si le paramètre -PointInTime n’est pas spécifié, la base de données est restaurée à l’heure de suppression.

Exemple 4 : Restaurer une base de données supprimée dans un pool élastique

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

La première commande obtient la sauvegarde de base de données supprimée que vous souhaitez restaurer à l’aide de Get-AzureRmSqlDeletedDatabaseBackup. La deuxième commande démarre la restauration à partir de la sauvegarde de base de données supprimée à l’aide de Restore-AzureRmSqlDatabase. Si le paramètre -PointInTime n’est pas spécifié, la base de données est restaurée à l’heure de suppression.

Exemple 5 : Géorestauration d’une base de données

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"

La première commande obtient la sauvegarde géoredondante pour la base de données nommée Database01, puis la stocke dans la variable $GeoBackup. La deuxième commande restaure la sauvegarde dans $GeoBackup dans la base de données SQL nommée RestoreDatabase.

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ComputeGeneration

Génération de calcul à affecter à la base de données restaurée

Type:	String
Alias:	Family
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DeletionDate

Spécifie la date de suppression en tant qu’objet DateTime . Pour obtenir un objet DateTime , utilisez l’applet de commande Get-Date.

Type:	DateTime
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Edition

Spécifie l’édition de la base de données SQL. Les valeurs valides pour ce paramètre sont :

Aucune
De base
standard
Premium
DataWarehouse
Gratuit
Étirer
GeneralPurpose
BusinessCritical

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ElasticPoolName

Spécifie le nom du pool élastique dans lequel placer la base de données SQL.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-FromDeletedDatabaseBackup

Indique que cette applet de commande restaure une base de données à partir d’une sauvegarde d’une base de données SQL supprimée. Vous pouvez utiliser l’applet de commande Get-AzureRMSqlDeletedDatabaseBackup pour obtenir la sauvegarde d’une base de données SQL supprimée.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-FromGeoBackup

Indique que cette applet de commande restaure une base de données SQL à partir d’une sauvegarde géoredondante. Vous pouvez utiliser l’applet de commande Get-AzureRMSqlDatabaseGeoBackup pour obtenir une sauvegarde géoredondante.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-FromLongTermRetentionBackup

Indique que cette applet de commande restaure une base de données SQL à partir d’une sauvegarde de rétention à long terme.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-FromPointInTimeBackup

Indique que cette applet de commande restaure une base de données SQL à partir d’une sauvegarde à un point dans le temps.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-LicenseType

Type de licence pour la base de données Azure Sql.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PointInTime

Spécifie le point dans le temps, en tant qu’objet DateTime , dans lequel vous souhaitez restaurer votre base de données SQL. Pour obtenir un objet DateTime , utilisez l’applet de commande Get-Date . Utilisez ce paramètre avec le paramètre FromPointInTimeBackup .

Type:	DateTime
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceGroupName

Spécifie le nom du groupe de ressources auquel cette applet de commande affecte la base de données SQL.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ResourceId

Spécifie l’ID de la ressource à restaurer.

Type:	String
Alias:	Id
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ServerName

Spécifie le nom du serveur de base de données SQL.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ServiceObjectiveName

Spécifie le nom de l’objectif de service.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-TargetDatabaseName

Spécifie le nom de la base de données à restaurer.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-VCore

Nombres Vcore de la base de données Azure Sql restaurée.

Type:	Int32
Alias:	Capacity
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

DateTime

String

Sorties

AzureSqlDatabaseModel

Partager via

Restore-AzureRmSqlDatabase

Syntaxe

Description

Exemples

Exemple 1 : Restaurer une base de données à partir d’un point dans le temps

Exemple 2 : Restaurer une base de données d’un point dans le temps vers un pool élastique

Exemple 3 : Restaurer une base de données supprimée

Exemple 4 : Restaurer une base de données supprimée dans un pool élastique

Exemple 5 : Géorestauration d’une base de données

Paramètres

-AsJob

-ComputeGeneration

-DefaultProfile

-DeletionDate

-Edition

-ElasticPoolName

-FromDeletedDatabaseBackup

-FromGeoBackup

-FromLongTermRetentionBackup

-FromPointInTimeBackup

-LicenseType

-PointInTime

-ResourceGroupName

-ResourceId

-ServerName

-ServiceObjectiveName

-TargetDatabaseName

-VCore

Entrées

Sorties

Ressources supplémentaires

Partager via

Restore-AzureRmSqlDatabase

Syntaxe

Description

Exemples

Exemple 1 : Restaurer une base de données à partir d’un point dans le temps

Exemple 2 : Restaurer une base de données d’un point dans le temps vers un pool élastique

Exemple 3 : Restaurer une base de données supprimée

Exemple 4 : Restaurer une base de données supprimée dans un pool élastique

Exemple 5 : Géorestauration d’une base de données

Paramètres

-AsJob

-ComputeGeneration

-DefaultProfile

-DeletionDate

-Edition

-ElasticPoolName

-FromDeletedDatabaseBackup

-FromGeoBackup

-FromLongTermRetentionBackup

-FromPointInTimeBackup

-LicenseType

-PointInTime

-ResourceGroupName

-ResourceId

-ServerName

-ServiceObjectiveName

-TargetDatabaseName

-VCore

Entrées

Sorties

Liens associés

Ressources supplémentaires