New-AzSqlDatabaseSecondary

Crea una base de datos secundaria para una base de datos existente e inicia la replicación de datos.

Sintaxis

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

Description

El cmdlet New-AzSqlDatabaseSecondary reemplaza el cmdlet Start-AzSqlDatabaseCopy cuando se usa para configurar la replicación geográfica para una base de datos. Devuelve el objeto de vínculo de replicación geográfica de la base de datos principal a la secundaria.

Ejemplos

Ejemplo 1: Establecer la replicación geográfica activa

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

Ejemplo 2: Establecer replicación geográfica activa y especificar el nombre de la base de datos del asociado para que sea diferente del nombre de la base de datos de origen

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

Parámetros

-AllowConnections

Especifica la intención de lectura de la base de datos secundaria de Azure SQL Database. Los valores permitidos para este parámetro son los siguientes:

  • No
  • All
Tipo:AllowConnections
Valores aceptados:No, All
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AssignIdentity

Genere y asigne una identidad de Microsoft Entra para esta base de datos para usarla con servicios de administración de claves como Azure KeyVault.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AutoPauseDelayInMinutes

Retraso de pausa automática en minutos para la base de datos (solo sin servidor), -1 para no participar

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BackupStorageRedundancy

Redundancia de almacenamiento de copia de seguridad usada para almacenar copias de seguridad de SQL Database. Las opciones son: Local, Zone y Geo.

Tipo:String
Valores aceptados:Local, Zone, Geo, GeoZone
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseName

Especifica el nombre de la base de datos que va a actuar como principal.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EncryptionProtector

Clave del protector de cifrado para la copia de SQL Database.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EncryptionProtectorAutoRotation

Estado de rotación automática de claves de AKV

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-FederatedClientId

Identificador de cliente federado para SQL Database. Se usa para el escenario de CMK entre inquilinos.

Tipo:Nullable<T>[Guid]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HighAvailabilityReplicaCount

Número de réplicas secundarias de solo lectura asociadas a la base de datos a la que se pueden enrutar las conexiones de intención de aplicación de solo lectura. Esta propiedad solo se puede establecer para las bases de datos de edición de Hiperescala.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KeyList

Lista de claves de AKV para la copia de SQL Database.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LicenseType

Tipo de licencia para la base de datos de Azure Sql.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MinimumCapacity

La capacidad mínima que la base de datos secundaria siempre tendrá asignada, si no está en pausa. Solo para las bases de datos de Azure Sql sin servidor.

Tipo:Double
Alias:MinVCore, MinCapacity
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PartnerDatabaseName

Nombre de la base de datos secundaria que se va a crear.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PartnerResourceGroupName

Especifica el nombre del grupo de recursos de Azure al que este cmdlet asigna la base de datos secundaria.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PartnerServerName

Especifica el nombre del servidor de base de datos de Azure SQL para que actúe como secundario.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Especifica el nombre del grupo de recursos de Azure al que este cmdlet asigna la base de datos principal.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SecondaryComputeGeneration

Generación de proceso de la base de datos secundaria de Azure Sql Database.

Tipo:String
Alias:Family
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecondaryComputeModel

Modelo de proceso para la base de datos de Azure Sql secundaria. Sin servidor o aprovisionado

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecondaryElasticPoolName

Especifica el nombre del grupo elástico en el que se va a colocar la base de datos secundaria.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecondaryServiceObjectiveName

Especifica el nombre del objetivo de servicio que se va a asignar a la base de datos secundaria.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecondaryType

El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo, Named y Standby.

Tipo:String
Valores aceptados:Named, Geo, Standby
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecondaryVCore

Número de núcleo virtual de la base de datos secundaria de Azure Sql Database.

Tipo:Int32
Alias:Capacity
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServerName

Especifica el nombre de SQL Server de la base de datos SQL principal.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Tags

Especifica los pares clave-valor en forma de una tabla hash que se va a asociar al vínculo de replicación de SQL Database. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

Tipo:Hashtable
Alias:Tag
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserAssignedIdentityId

Lista de identidades asignadas por el usuario para la copia de SQL Database.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ZoneRedundant

Redundancia de zona que se va a asociar a Azure Sql Database. Esta propiedad solo se puede establecer para las bases de datos de edición de Hiperescala.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Salidas

AzureReplicationLinkModel