Get-AzureSqlDatabaseCopy

Vérifie l’état des relations de copie.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

Get-AzureSqlDatabaseCopy
   -ServerName <String>
   [-DatabaseName <String>]
   [-PartnerServer <String>]
   [-PartnerDatabase <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSqlDatabaseCopy
   -ServerName <String>
   -DatabaseCopy <DatabaseCopy>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSqlDatabaseCopy
   -ServerName <String>
   -Database <Database>
   [-PartnerServer <String>]
   [-PartnerDatabase <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureSqlDatabaseCopy vérifie l’état d’une ou plusieurs relations de copie actives. Exécutez cette applet de commande après avoir exécuté l’applet de commande Start-AzureSqlDatabaseCopy ou Stop-AzureSqlDatabaseCopy. Vous pouvez vérifier une relation de copie spécifique, toutes les relations de copie ou une liste filtrée de relations de copie, telles que toutes les copies sur un serveur cible spécifique. Vous pouvez exécuter cette applet de commande sur le serveur qui héberge la base de données source ou cible.

Cette applet de commande est synchrone. L’applet de commande bloque la console Azure PowerShell jusqu’à ce qu’elle retourne un objet d’état.

Les paramètres PartnerServer et PartnerDatabase sont facultatifs. Si vous ne spécifiez pas un paramètre, cette applet de commande retourne une table des résultats. Pour afficher l’état d’une base de données particulière uniquement, spécifiez les deux paramètres.

Exemples

Exemple 1 : Obtenir l’état de copie d’une base de données

PS C:\> Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf658"

Cette commande obtient l’état de la base de données nommée Orders sur le serveur nommé lpqd0zbr8y. Le paramètre PartnerServer limite cette commande au serveur bk0b8kf658.

Exemple 2 : Obtenir l’état de toutes les copies sur un serveurGet l’état de toutes les copies sur un serveur

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

Cette commande obtient l’état de toutes les copies actives sur le serveur nommé lpqd0zbr8y.

Paramètres

-Database

Spécifie un objet qui représente la source Azure SQL Database. Cette applet de commande obtient l’état de copie de la base de données spécifiée par ce paramètre.

Type:Database
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseCopy

Spécifie un objet qui représente une base de données. Cette applet de commande obtient l’état de copie de la base de données spécifiée par ce paramètre. Ce paramètre accepte l’entrée de pipeline.

Type:DatabaseCopy
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseName

Spécifie le nom de la base de données source. Cette applet de commande obtient l’état de copie de la base de données spécifiée par ce paramètre.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerDatabase

Spécifie le nom de la base de données secondaire. Si cette base de données est introuvable dans la vue de gestion dynamique sys.dm_database_copies, cette applet de commande retourne un objet d’état vide.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServer

Spécifie le nom du serveur qui héberge la base de données cible. Si ce serveur n’est pas trouvé dans la vue de gestion dynamique sys.dm_database_copies, cette applet de commande retourne un objet d’état vide.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

Spécifie le nom du serveur sur lequel réside la copie de base de données.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

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

Sorties

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

Notes

  • Authentification : cette applet de commande nécessite une authentification basée sur des certificats. Pour obtenir un exemple d’utilisation de l’authentification basée sur un certificat pour définir l’abonnement actuel, consultez l’applet de commande New-AzureSqlDatabaseServerContext.