Partager via

Start-AzureSqlDatabaseCopy

  • Référence
Module:
Azure

Démarre une opération de copie d’une base de données Azure SQL.

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-AzureSqlDatabaseCopy
     -ServerName <String>
     -Database <Database>
     [-PartnerServer <String>]
     -PartnerDatabase <String>
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -Database <Database>
     -PartnerServer <String>
     [-PartnerDatabase <String>]
     [-ContinuousCopy]
     [-OfflineSecondary]
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -DatabaseName <String>
     [-PartnerServer <String>]
     -PartnerDatabase <String>
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -DatabaseName <String>
     -PartnerServer <String>
     [-PartnerDatabase <String>]
     [-ContinuousCopy]
     [-OfflineSecondary]
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

L’applet de commande Start-AzureSqlDatabaseCopy démarre une opération de copie ponctuelle ou une opération de copie continue d’une base de données Azure SQL spécifique. Cette applet de commande n’est pas transactionnelle.

La base de données d’origine est la base de données source. La copie est la base de données secondaire ou cible. Pour une copie continue, les bases de données source et cible ne peuvent pas résider sur le même serveur, et les serveurs qui hébergent les bases de données source et cible doivent faire partie du même abonnement.

Si vous ne spécifiez pas le paramètre ContinuousCopy , cette applet de commande crée une copie unique de la base de données source. Lorsque la réponse est reçue, l’opération peut toujours être en cours. Vous pouvez surveiller l’opération à l’aide de l’applet de commande Get-AzureSqlDatabaseCopy ou Get-AzureSqlDatabaseOperation.

Si vous spécifiez ContinuousCopy, cette applet de commande crée une copie continue de la base de données source. Lorsque la réponse est reçue, l’opération est en cours. Vous pouvez surveiller l’opération à l’aide de Get-AzureSqlDatabaseCopy ou get-AzureSqlDatabaseOperation.

Vous pouvez créer une copie continue en tant que base de données en ligne ou hors connexion. La copie continue en ligne est utilisée pour configurer la géoréplication active pour Azure SQL Databasehttps://azure.microsoft.com/en-us/documentation/articles/sql-database-geo-replication-overview/. La copie continue hors connexion est utilisée pour configurer la géoréplication standard pour Azure SQL Databasehttps://azure.microsoft.com/en-us/documentation/articles/sql-database-business-continuity-scenarios/.

Exemples

Exemple 1 : Planifier une copie continue de base de données

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf65" -ContinuousCopy

Cette commande planifie une copie continue de la base de données nommée Orders sur le serveur nommé lpqd0zbr8y. La commande crée une base de données cible sur le serveur nommé bk0b8kf658.

Exemple 2 : Créer une copie ponctuelle sur le même serveur

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerDatabase "OrdersCopy"

Cette commande crée une copie unique de la base de données nommée Orders sur le serveur nommé lpqd0zbr8y. La commande crée une copie nommée OrdersCopy sur le même serveur.

Exemple 3 : Planifier une copie de base de données hors connexion continue

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf65" -ContinuousCopy -OfflineSecondary

Cette commande planifie une copie continue de la base de données nommée Orders sur le serveur nommé lpqd0zbr8y. Cette commande crée une base de données cible hors connexion sur le serveur nommé bk0b8kf658.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

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

-ContinuousCopy

Indique que la copie de base de données sera une copie continue (base de données réplica). La copie continue n’est pas prise en charge dans le même serveur. Si ce paramètre n’est pas spécifié, une copie ponctuelle est effectuée. Pour une copie ponctuelle, les bases de données sources et partenaires doivent se trouver sur le même serveur.

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

-Database

Spécifie un objet qui représente la source Azure SQL Database. Ce paramètre accepte l’entrée de pipeline.

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

-DatabaseName

Spécifie le nom de la base de données source.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-OfflineSecondary

Spécifie qu’une copie continue est une copie passive plutôt qu’une copie active. Si la base de données source est une base de données d’édition Standard, ce paramètre est requis. Si ce paramètre est spécifié, ContinuousCopy doit également être spécifié.

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

-PartnerDatabase

Spécifie le nom de la base de données cible. Si vous spécifiez le paramètre ContinuousCopy , la valeur de PartnerDatabase doit correspondre au nom de la base de données source. Si vous ne spécifiez pas ContinuousCopy, vous devez spécifier un nom pour la base de données cible, qui peut être différent du nom de la base de données source.

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

-PartnerServer

Spécifie le nom du serveur qui héberge la base de données cible. Ce serveur doit se trouver dans le même abonnement Azure que le serveur de base de données source.

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

-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

-ServerName

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

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
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.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.
  • Supervision : Pour vérifier l’état d’une ou plusieurs relations de copie continue actives sur le serveur, utilisez l’applet de commande Get-AzureSqlDatabaseCopy . Pour vérifier l’état des opérations à la fois à la source et à la cible de la relation de copie continue, utilisez l’applet de commande Get-AzureSqlDatabaseOperation .