Sdílet prostřednictvím


New-AzSqlDatabaseSecondary

Vytvoří sekundární databázi pro existující databázi a spustí replikaci dat.

Syntaxe

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

Rutina New-AzSqlDatabaseSecondary nahrazuje rutinu Start-AzSqlDatabaseCopy, pokud se používá k nastavení geografické replikace pro databázi. Vrátí objekt propojení geografické replikace z primární databáze do sekundární databáze.

Příklady

Příklad 1: Vytvoření aktivní geografické replikace

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

Příklad 2: Vytvořte aktivní geografickou replikaci a zadejte název partnerské databáze, který se má lišit od názvu zdrojové databáze.

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

Parametry

-AllowConnections

Určuje záměr čtení sekundární služby Azure SQL Database. Tento parametr přijímá tyto hodnoty:

  • No
  • Vše
Typ:AllowConnections
Přípustné hodnoty:No, All
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AssignIdentity

Vygenerujte a přiřaďte identitu Microsoft Entra pro tuto databázi pro použití se službami pro správu klíčů, jako je Azure KeyVault.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AutoPauseDelayInMinutes

Prodleva automatického pozastavení v minutách pro databázi (jenom bez serveru), -1, která se odhlásí

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BackupStorageRedundancy

Redundance úložiště zálohování použitá k ukládání záloh pro službu SQL Database. Možnosti jsou: místní, zónová a geografická oblast.

Typ:String
Přípustné hodnoty:Local, Zone, Geo, GeoZone
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DatabaseName

Určuje název databáze, která bude fungovat jako primární.

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EncryptionProtector

Šifrovací klíč ochrany pro kopírování služby SQL Database.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EncryptionProtectorAutoRotation

Stav automatické obměně klíče AKV

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-FederatedClientId

ID federovaného klienta pro službu SQL Database. Používá se pro scénář CMK napříč tenanty.

Typ:Nullable<T>[Guid]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HighAvailabilityReplicaCount

Počet sekundárních replik jen pro čtení přidružených k databázi, do které se můžou směrovat připojení záměru aplikace jen pro čtení. Tato vlastnost je nastavena pouze pro databáze edic Hyperscale.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-KeyList

Seznam klíčů AKV pro kopii služby SQL Database.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LicenseType

Typ licence pro databázi Azure Sql.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MinimumCapacity

Minimální kapacita, kterou sekundární databáze bude mít vždy přidělenou, pokud není pozastavena. Pouze pro bezserverové databáze Azure Sql.

Typ:Double
Aliasy:MinVCore, MinCapacity
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PartnerDatabaseName

Název sekundární databáze, která se má vytvořit.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PartnerResourceGroupName

Určuje název skupiny prostředků Azure, ke které tato rutina přiřadí sekundární databázi.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PartnerServerName

Určuje název databázového serveru Azure SQL, který bude fungovat jako sekundární.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků Azure, ke které tato rutina přiřadí primární databázi.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SecondaryComputeGeneration

Generování výpočetních prostředků sekundární služby Azure Sql Database.

Typ:String
Aliasy:Family
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SecondaryComputeModel

Výpočetní model pro sekundární databázi Azure Sql. Bezserverová nebo zřízená

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SecondaryElasticPoolName

Určuje název elastického fondu, do kterého se má umístit sekundární databáze.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SecondaryServiceObjectiveName

Určuje název cíle služby, který se má přiřadit sekundární databázi.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SecondaryType

Sekundární typ databáze, pokud je sekundární. Platné hodnoty jsou Geo, Named a Standby.

Typ:String
Přípustné hodnoty:Named, Geo, Standby
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SecondaryVCore

Čísla virtuálních jader sekundární služby Azure Sql Database.

Typ:Int32
Aliasy:Capacity
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerName

Určuje název SQL Serveru primární databáze SQL.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tags

Určuje páry klíč-hodnota ve formě hash tabulky, která se přidruží k propojení replikace služby SQL Database. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliasy:Tag
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserAssignedIdentityId

Seznam identity přiřazené uživatelem pro kopii služby SQL Database.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ZoneRedundant

Redundance zóny, která se má přidružit ke službě Azure Sql Database. Tato vlastnost je nastavena pouze pro databáze edic Hyperscale.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

AzureReplicationLinkModel