Partager via

New-AzSqlDatabaseSecondary

Module:
Az.Sql Module

Crée une base de données secondaire pour une base de données existante puis lance la réplication des données.

Syntaxe

DtuBasedDatabase (Par défaut) 

New-AzSqlDatabaseSecondary
    [-DatabaseName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -PartnerResourceGroupName <String>
    -PartnerServerName <String>
    [-SecondaryServiceObjectiveName <String>]
    [-SecondaryElasticPoolName <String>]
    [-Tags <Hashtable>]
    [-PartnerDatabaseName <String>]
    [-AllowConnections <AllowConnections>]
    [-AsJob]
    [-LicenseType <String>]
    [-BackupStorageRedundancy <String>]
    [-SecondaryType <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-ZoneRedundant]
    [-AssignIdentity]
    [-EncryptionProtector <String>]
    [-UserAssignedIdentityId <String[]>]
    [-KeyList <String[]>]
    [-FederatedClientId <Guid>]
    [-EncryptionProtectorAutoRotation]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

VcoreBasedDatabase 

New-AzSqlDatabaseSecondary
    [-DatabaseName] <String>
    [-ServerName] <String>
    [-ResourceGroupName] <String>
    -PartnerResourceGroupName <String>
    -PartnerServerName <String>
    -SecondaryComputeGeneration <String>
    -SecondaryVCore <Int32>
    [-Tags <Hashtable>]
    [-PartnerDatabaseName <String>]
    [-AllowConnections <AllowConnections>]
    [-AsJob]
    [-SecondaryComputeModel <String>]
    [-LicenseType <String>]
    [-AutoPauseDelayInMinutes <Int32>]
    [-MinimumCapacity <Double>]
    [-BackupStorageRedundancy <String>]
    [-SecondaryType <String>]
    [-HighAvailabilityReplicaCount <Int32>]
    [-ZoneRedundant]
    [-AssignIdentity]
    [-EncryptionProtector <String>]
    [-UserAssignedIdentityId <String[]>]
    [-KeyList <String[]>]
    [-FederatedClientId <Guid>]
    [-EncryptionProtectorAutoRotation]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande New-AzSqlDatabaseSecondary remplace l’applet de commande Start-AzSqlDatabaseCopy lors de la configuration de la géoréplication pour une base de données. Elle retourne l’objet de liaison de géoréplication de la base de données primaire vers la base de données secondaire.

Exemples

Exemple 1 : Établir un Geo-Replication actif

$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -AllowConnections "All"

Exemple 2 : Établir un Geo-Replication actif et spécifier le nom de la base de données partenaire à différer du nom de la base de données source

$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -PartnerDatabaseName $secondarydatabasename -AllowConnections "All"

Paramètres

-AllowConnections

Spécifie l’intention de lecture de la base de données Azure SQL secondaire. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Non
  • Tous

Propriétés du paramètre

Type:AllowConnections
Valeur par défaut:None
Valeurs acceptées:No, All
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AsJob

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AssignIdentity

Générez et affectez une identité Microsoft Entra pour cette base de données à utiliser avec des services de gestion de clés comme Azure KeyVault.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AutoPauseDelayInMinutes

Délai de pause automatique en minutes pour la base de données (serverless uniquement), -1 de désactiver

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-BackupStorageRedundancy

Redondance du stockage de sauvegarde utilisée pour stocker les sauvegardes pour la base de données SQL. Les options sont les suivantes : Local, Zone et Geo.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Local, Zone, Geo, GeoZone
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseName

Spécifie le nom de la base de données à agir comme principal.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionProtector

Clé de protecteur de chiffrement pour la copie sql Database.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionProtectorAutoRotation

État de rotation automatique de la clé AKV

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-FederatedClientId

ID client fédéré pour la base de données SQL. Il est utilisé pour le scénario CMK interlocataire.

Propriétés du paramètre

Type:

Nullable<T>[Guid]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-HighAvailabilityReplicaCount

Nombre de réplicas secondaires en lecture seule associés à la base de données vers laquelle les connexions d’intention d’application en lecture seule peuvent être routées. Cette propriété est uniquement paramétrable pour les bases de données d’édition Hyperscale.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-KeyList

Liste des clés AKV pour la copie sql Database.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LicenseType

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MinimumCapacity

Capacité minimale que la base de données secondaire aura toujours allouée, si elle n’est pas suspendue. Pour les bases de données Azure Sql serverless uniquement.

Propriétés du paramètre

Type:Double
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:MinVCore, MinCapacity

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PartnerDatabaseName

Nom de la base de données secondaire à créer.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PartnerResourceGroupName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PartnerServerName

Spécifie le nom du serveur de base de données Azure SQL pour qu’il agisse comme secondaire.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PartnerSubscriptionId

Spécifie l’abonnement du serveur de base de données Azure SQL s’il est différent de la source.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-SecondaryComputeGeneration

Génération de calcul du serveur secondaire Azure Sql Database.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Famille

Jeux de paramètres

VcoreBasedDatabase
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SecondaryComputeModel

Modèle de calcul pour la base de données Azure Sql secondaire. Serverless ou provisionné

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VcoreBasedDatabase
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SecondaryElasticPoolName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DtuBasedDatabase
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SecondaryServiceObjectiveName

Spécifie le nom de l’objectif de service à affecter à la base de données secondaire.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DtuBasedDatabase
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SecondaryType

Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont geo, nommées et de secours.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Named, Geo, Standby
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SecondaryVCore

Nombres Vcore de la base de données secondaire Azure Sql Database.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Capacity

Jeux de paramètres

VcoreBasedDatabase
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ServerName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Tags

Spécifie les paires clé-valeur sous la forme d’une table de hachage à associer au lien de réplication SQL Database. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Tag

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UserAssignedIdentityId

Liste des identités attribuées par l’utilisateur pour la copie sql Database.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ZoneRedundant

Redondance de zone à associer à Azure Sql Database. Cette propriété est uniquement paramétrable pour les bases de données d’édition Hyperscale.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Sorties

AzureReplicationLinkModel