New-AzSqlDatabaseSecondary

Modul:

Az.Sql

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

Syntax

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

Type:	AllowConnections
Accepted values:	No, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Spuštění rutiny na pozadí

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

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

-AutoPauseDelayInMinutes

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

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

Type:	String
Accepted values:	Local, Zone, Geo, GeoZone
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseName

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

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

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionProtector

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

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

-EncryptionProtectorAutoRotation

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

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

-FederatedClientId

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

Type:	Nullable<T>[Guid]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-KeyList

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

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

-LicenseType

Typ licence pro databázi Azure Sql.

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

Type:	Double
Aliases:	MinVCore, MinCapacity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartnerDatabaseName

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

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

-PartnerResourceGroupName

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

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

-PartnerServerName

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

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

-ResourceGroupName

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

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

-SecondaryComputeGeneration

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

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

-SecondaryComputeModel

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

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

-SecondaryElasticPoolName

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

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

-SecondaryServiceObjectiveName

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

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

-SecondaryType

Sekundární typ databáze, pokud je sekundární. Platné hodnoty jsou geo a pojmenované.

Type:	String
Accepted values:	Named, Geo, Standby
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondaryVCore

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

Type:	Int32
Aliases:	Capacity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerName

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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"}

Type:	Hashtable
Aliases:	Tag
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserAssignedIdentityId

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

Vstupy

String

Výstupy

AzureReplicationLinkModel

Související odkazy

• Remove-AzSqlDatabaseSecondary
• Set-AzSqlDatabaseSecondary
• Dokumentace ke službě SQL Database