New-AzSqlDatabaseSecondary

Referenz

Modul:: Az.Sql

Erstellt eine sekundäre Datenbank für eine vorhandene Datenbank und startet die Datenreplikation.

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>]

Beschreibung

Das Cmdlet New-AzSqlDatabaseSecondary ersetzt das Cmdlet Start-AzSqlDatabaseCopy, wenn es zum Einrichten der Georeplikation für eine Datenbank verwendet wird. Es gibt das Georeplikationsverknüpfungsobjekt von der primären zur sekundären Datenbank zurück.

Beispiele

Beispiel 1: Einrichten der aktiven Georeplikation

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

Beispiel 2: Einrichten der aktiven Geo-Replikation und Angeben des Partnerdatenbanknamens, der vom Quelldatenbanknamen abweichen soll

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

Parameter

-AllowConnections

Gibt die Leseabsicht des sekundären Azure SQL-Datenbank an. Zulässige Werte für diesen Parameter:

No
Alle

Typ:	AllowConnections
Zulässige Werte:	No, All
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AsJob

Cmdlet im Hintergrund ausführen

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AssignIdentity

Generieren und Zuweisen einer Microsoft Entra-Identität für diese Datenbank für die Verwendung mit Schlüsselverwaltungsdiensten wie Azure KeyVault.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AutoPauseDelayInMinutes

Die automatische Pausenverzögerung in Minuten für Datenbank(nur serverlos), -1 zum Abmelden

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BackupStorageRedundancy

Die Sicherungsspeicherredundanz, die zum Speichern von Sicherungen für die SQL-Datenbank verwendet wird. Optionen sind: Lokal, Zone und Geo.

Typ:	String
Zulässige Werte:	Local, Zone, Geo, GeoZone
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DatabaseName

Gibt den Namen der Datenbank an, die als primär fungieren soll.

Typ:	String
Position:	2
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionProtector

Der Verschlüsselungsschutzschlüssel für SQL-Datenbank Kopie.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionProtectorAutoRotation

Der Status der automatischen Drehung des AKV-Schlüssels

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-FederatedClientId

Die Partnerclient-ID für die SQL-Datenbank. Sie wird für das mandantenübergreifende CMK-Szenario verwendet.

Typ:	Nullable<T>[Guid]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-HighAvailabilityReplicaCount

Die Anzahl der readonly secondary replicas associated with the database to which readonly application intent connections may be routingd. Diese Eigenschaft ist nur für Hyperscale Edition-Datenbanken festgelegt.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-KeyList

Die Liste der AKV-Schlüssel für die SQL-Datenbank Kopie.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-LicenseType

Der Lizenztyp für die Azure SQL-Datenbank.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MinimumCapacity

Die minimale Kapazität, die die sekundäre Datenbank immer zugewiesen hat, wenn sie nicht angehalten wird. Nur für serverlose Azure SQL-Datenbanken.

Typ:	Double
Aliase:	MinVCore, MinCapacity
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartnerDatabaseName

Der Name der zu erstellenden sekundären Datenbank.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartnerResourceGroupName

Gibt den Namen der Azure-Ressourcengruppe an, der dieses Cmdlet die sekundäre Datenbank zuweist.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PartnerServerName

Gibt den Namen des Azure SQL-Datenbankservers an, der als sekundär fungiert.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Gibt den Namen der Azure-Ressourcengruppe an, der dieses Cmdlet die primäre Datenbank zuweist.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-SecondaryComputeGeneration

Die Berechnungsgenerierung der sekundären Azure SQL-Datenbank.

Typ:	String
Aliase:	Family
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SecondaryComputeModel

Das Computemodell für sekundäre Azure SQL-Datenbank. Serverlos oder bereitgestellt

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SecondaryElasticPoolName

Gibt den Namen des elastischen Pools an, in dem die sekundäre Datenbank platziert werden soll.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SecondaryServiceObjectiveName

Gibt den Namen des Dienstziels an, das der sekundären Datenbank zugewiesen werden soll.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SecondaryType

Der sekundäre Typ der Datenbank, wenn es sich um eine sekundäre Datenbank handelt. Gültige Werte sind Geo, Named and Standby.

Typ:	String
Zulässige Werte:	Named, Geo, Standby
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SecondaryVCore

Die Vcore-Zahlen der sekundären Azure SQL-Datenbank.

Typ:	Int32
Aliase:	Capacity
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServerName

Gibt den Namen des SQL Server des primären SQL-Datenbank an.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Tags

Gibt die Schlüssel-Wert-Paare in Form einer Hashtabelle an, die der SQL-Datenbank Replikationsverknüpfung zugeordnet werden soll. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

Typ:	Hashtable
Aliase:	Tag
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UserAssignedIdentityId

Die Liste der vom Benutzer zugewiesenen Identitäten für die SQL-Datenbank Kopie.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ZoneRedundant

Die Zonenredundanz, die der Azure SQL-Datenbank zugeordnet werden soll. Diese Eigenschaft ist nur für Hyperscale Edition-Datenbanken festgelegt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

Ausgaben

AzureReplicationLinkModel

Freigeben über