Partager via

Start-AzureSqlDatabaseRestore

  • Référence
Module:
Azure

Effectue une restauration à un point dans le temps d’une base de données.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Start-AzureSqlDatabaseRestore
     [-SourceServerName <String>]
     -SourceDatabase <Database>
     [-TargetServerName <String>]
     -TargetDatabaseName <String>
     [-PointInTime <DateTime>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSqlDatabaseRestore
     [-SourceServerName <String>]
     -SourceRestorableDroppedDatabase <RestorableDroppedDatabase>
     [-TargetServerName <String>]
     -TargetDatabaseName <String>
     [-PointInTime <DateTime>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSqlDatabaseRestore
     -SourceServerName <String>
     -SourceDatabaseName <String>
     [-TargetServerName <String>]
     -TargetDatabaseName <String>
     [-PointInTime <DateTime>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSqlDatabaseRestore
     -SourceServerName <String>
     -SourceDatabaseName <String>
     -SourceDatabaseDeletionDate <DateTime>
     [-TargetServerName <String>]
     [-RestorableDropped]
     -TargetDatabaseName <String>
     [-PointInTime <DateTime>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]

Description

L’applet de commande Start-AzureSqlDatabaseRestore effectue une restauration dans le temps d’une base de données De base, Standard ou Premium. Azure SQL Database conserve les sauvegardes de base de données de base 7 jours, Standard pendant 14 jours et Premium pendant 35 jours. L’opération de restauration crée une base de données. Si la base de données source n’est pas supprimée, le paramètre SourceDatabaseName et TargetDatabaseName doit avoir des valeurs différentes.

Azure SQL Database ne prend actuellement pas en charge la restauration entre serveurs. Les noms de serveur source et cible doivent être identiques.

Exemples

Exemple 1 : Restaurer une base de données spécifiée en tant qu’objet à un point dans le temps

PS C:\> $Database = Get-AzureSqlDatabase -ServerName "Server01" -DatabaseName "Database17" 
PS C:\> $Operation = Start-AzureSqlDatabaseRestore -SourceDatabase $Database -TargetDatabaseName "DatabaseRestored" -PointInTime "2013-01-01 06:00:00"

La première commande obtient un objet de base de données pour la base de données nommée Database17 sur le serveur nommé Server01, puis la stocke dans la variable $Database.

La deuxième commande restaure la base de données à un point spécifique dans le temps. La commande spécifie le nom de la nouvelle base de données.

Exemple 2 : Restaurer une base de données spécifiée par un nom à un point dans le temps

PS C:\> $Operation = Start-AzureSqlDatabaseRestore -SourceServerName "Server01" -SourceDatabaseName "Database17" -TargetDatabaseName "DatabaseRestored" -PointInTime "2013-01-01 06:00:00"

Cette commande restaure la base de données nommée Database17 à un point spécifique dans le temps. La commande spécifie le nom de la nouvelle base de données.

Exemple 3 : Restaurer une base de données supprimée spécifiée en tant qu’objet à un point dans le temps

PS C:\> $Database = Get-AzureSqlDatabase -RestorableDropped -ServerName "Server01" -DatabaseName "Database01" -DatabaseDeletionDate "2012-11-09T22:59:43.000Z" 
PS C:\> $Operation = Start-AzureSqlDatabaseRestore -SourceRestorableDroppedDatabase $Database -TargetDatabaseName "DroppedDatabaseRestored"

La première commande obtient un objet de base de données pour la base de données nommée Database01 sur le serveur nommé Server01. La commande spécifie le paramètre RestorableDropped . Par conséquent, l’applet de commande obtient la base de données supprimée pouvant être restaurée, le point de restauration spécifié. La commande stocke cet objet de base de données dans la variable $Database.

La deuxième commande restaure la base de données supprimée spécifiée par $Database. La commande spécifie le nom de la nouvelle base de données.

Paramètres

-PointInTime

Spécifie le point de restauration vers lequel restaurer la base de données. Une fois l’opération de restauration terminée, la base de données est restaurée à l’état à la date et à l’heure spécifiées par ce paramètre. Par défaut, pour une base de données dynamique définie sur l’heure actuelle et pour une base de données supprimée, cette applet de commande utilise l’heure à laquelle la base de données a été supprimée.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-RestorableDropped

Indique que cette applet de commande restaure une base de données supprimée pouvant être restauré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

-SourceDatabase

Spécifie le nom de la base de données que cette applet de commande restaure.

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

-SourceDatabaseDeletionDate

Spécifie la date et l’heure de suppression de la base de données. Vous devez inclure des millisecondes lorsque vous spécifiez l’heure de suppression de la base de données réelle.

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

-SourceDatabaseName

Spécifie le nom de la base de données dynamique que cette applet de commande restaure.

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

-SourceRestorableDroppedDatabase

Spécifie un objet qui représente la base de données supprimée pouvant être restaurée par cette applet de commande. Pour obtenir un objet RestorableDroppedDatabase , utilisez l’applet de commande Get-AzureSqlDatabase et spécifiez le paramètre RestorableDropped .

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

-SourceServerName

Spécifie le nom du serveur sur lequel la base de données source est active et en cours d’exécution, ou sur lequel la base de données source a été exécutée avant sa suppression.

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

-TargetDatabaseName

Spécifie le nom de la nouvelle base de données créée par l’opération de restauration.

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

-TargetServerName

Spécifie le nom du serveur sur lequel cette applet de commande restaure la base de données.

Azure SQL Database ne prend actuellement pas en charge la restauration entre serveurs. Les noms de serveur source et cible doivent être identiques.

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

Entrées

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestorableDroppedDatabase

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Sorties

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestoreDatabaseOperation

Notes

  • Vous devez utiliser l’authentification basée sur des certificats pour exécuter cette applet de commande. Exécutez les commandes suivantes sur l’ordinateur où exécutez cette applet de commande :

PS C:\\\> $subId = \<Subscription ID\> PS C:\\\> $thumbprint = \<Certificate Thumbprint\> PS C:\\\> $myCert = Get-Item Cert:\CurrentUser\My\$thumbprint PS C:\\\> Set-AzureSubscription -SubscriptionName "mySubscription" -SubscriptionId $subId -Certificate $myCert PS C:\\\> Select-AzureSubscription -SubscriptionName "mySubscription"