Partager via

Get-AzureSqlDatabase

  • Référence
Module:
Azure

Récupère une ou plusieurs bases 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

Get-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   [-Database <Database>]
   [-DatabaseName <String>]
   [-RestorableDropped]
   [-RestorableDroppedDatabase <RestorableDroppedDatabase>]
   [-DatabaseDeletionDate <DateTime>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSqlDatabase
   -ServerName <String>
   [-Database <Database>]
   [-DatabaseName <String>]
   [-RestorableDropped]
   [-RestorableDroppedDatabase <RestorableDroppedDatabase>]
   [-DatabaseDeletionDate <DateTime>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureSqlDatabase récupère une ou plusieurs instances d’une base de données Azure SQL à partir d’un serveur Azure SQL Database. Vous pouvez spécifier le serveur avec un contexte de connexion de serveur Azure SQL Database que vous créez à l’aide de l’applet de commande New-AzureSqlDatabaseServerContext . Ou, si vous spécifiez le nom du serveur Azure SQL Database, l’applet de commande utilise les informations d’abonnement Azure actuelles pour authentifier la demande d’accès au serveur.

Si vous ne spécifiez pas de base de données, l’applet de commande Get-AzureSqlDatabase retourne toutes les bases de données du serveur spécifié.

Récupération des bases de données supprimées pouvant être restaurées :

Récupérez les bases de données supprimées pouvant être restaurées à l’aide du paramètre RestorableDropped . Pour renvoyer toutes les bases de données supprimées pouvant être restaurées, utilisez le paramètre RestorableDropped sans DatabaseName et DatabaseDeletionDate. Pour renvoyer une base de données supprimée spécifique, utilisez le paramètre RestorableDropped avec les paramètres DatabaseName et DatabaseDeletionDate . Lors de la récupération d’une base de données supprimée spécifique à l’aide du paramètre DatabaseName, vous devez également inclure le paramètre DatabaseDeletionDate et la valeur DatabaseDeletionDate spécifiée doit inclure des millisecondes pour correspondre à la base de données souhaitée.

L’applet de commande Get-AzureSqlDatabase retourne toutes les bases de données supprimées pouvant être restaurées sur un serveur ou une base de données spécifique qui correspond à DatabaseName et DatabaseDeletionDate. Pour retourner des bases de données supprimées pouvant être restaurées qui répondent à différents critères, tels que toutes les bases de données supprimées pouvant être restaurées d’un nom spécifique, vous devez retourner toutes les bases de données supprimées pouvant être restaurées, puis filtrer les résultats sur le client.

Exemples

Exemple 1 : Récupérer toutes les bases de données sur un serveur

PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y"

Cette commande récupère toutes les bases de données sur le serveur nommé lpqd0zbr8y.

Exemple 2 : Récupérer toutes les bases de données supprimées pouvant être restaurées sur un serveur

PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -RestorableDropped

Cette commande récupère toutes les bases de données supprimées pouvant être restaurées sur le serveur nommé lpqd0zbr8y.

Exemple 3 : Récupérer une base de données à partir d’un serveur spécifié par un contexte de connexion

PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"

Cette commande récupère la base de données nommée Database01 à partir du serveur spécifié par le contexte de connexion $Context.

Exemple 4 : Stocker un objet de base de données dans une variable

PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"

Cette commande récupère la base de données nommée Database01 à partir du serveur nommé lpqd0zbr8y. La commande stocke l’objet de base de données dans la variable $Database 01.

Exemple 5 : Récupérer une base de données supprimée pouvant être restaurée

PS C:\> $DroppedDB = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -DatabaseDeletionDate "2012-11-09T22:59:43.000Z" -RestorableDropped

Cette commande récupère la base de données supprimée pouvant être restaurée nommée Database01 qui a été supprimée le 11/9/2012 à partir du serveur nommé lpqd0zbr8y. Cette commande stocke les résultats dans la variable $DroppedDB.

Exemple 6 : Récupérer toutes les bases de données supprimées pouvant être restaurées sur un serveur et filtrer les résultats

PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -RestorableDropped | Where-Object {$_.Name -eq "ContactDB"}

Cette commande récupère toutes les bases de données supprimées pouvant être restaurées sur le serveur nommé lpqd0zbr8y, puis filtre les résultats uniquement sur les bases de données nommées ContactDB.

Paramètres

-ConnectionContext

Spécifie le contexte de connexion d’un serveur à partir duquel récupérer une base de données.

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

-Database

Spécifie un objet qui représente la base de données récupérée par cette applet de commande.

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

-DatabaseDeletionDate

Spécifie la date et l’heure d’une suppression. Si vous spécifiez le paramètre RestorableDropped , spécifiez ce paramètre pour récupérer une base de données supprimée pouvant être restaurée en fonction de la date et de l’heure de suppression.

Le paramètre DatabaseDeletionDate doit inclure des millisecondes pour correspondre à l’heure de la base de données souhaitée. La spécification d’une valeur sans millisecondes entraîne la découverte de la base de données.

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

-DatabaseName

Spécifie le nom de la base de données récupérée par cette applet de commande.

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

-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 retourne des objets RestorableDroppedDatabase au lieu d’objets Database . Vous pouvez utiliser le paramètre DatabaseDeletionDate pour sélectionner une base de données supprimée spécifique pouvant être restaurée.

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

-RestorableDroppedDatabase

Spécifie un objet qui représente la base de données supprimée pouvant être restaurée que cette applet de commande récupère.

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

-ServerName

Spécifie le nom du serveur qui contient la base de données récupérée par cette applet de commande. L’applet de commande utilise l’abonnement Azure actuel pour accéder au serveur.

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

Entrées

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

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

Sorties

IEnumerable\<Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database\>

Cette applet de commande retourne un objet De base de données si vous ne spécifiez pas le paramètre RestorableDropped .

IEnumerable\<Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestorableDroppedDatabase\>

Cette applet de commande retourne un objet RestorableDroppedDatabase si vous spécifiez le paramètre RestorableDropped .