Auf Englisch lesen

Freigeben über

New-AzSqlDatabaseCopy

  • Referenz
Modul:
Az.Sql

Erstellt eine Kopie einer SQL-Datenbank, die die Momentaufnahme zur aktuellen Zeit verwendet.

Syntax

PowerShell 
New-AzSqlDatabaseCopy
   [-DatabaseName] <String>
   [-ServiceObjectiveName <String>]
   [-ElasticPoolName <String>]
   [-Tags <Hashtable>]
   [-CopyResourceGroupName <String>]
   [-CopyServerName <String>]
   -CopyDatabaseName <String>
   [-AsJob]
   [-LicenseType <String>]
   [-BackupStorageRedundancy <String>]
   [-ZoneRedundant]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
PowerShell 
New-AzSqlDatabaseCopy
   [-DatabaseName] <String>
   [-Tags <Hashtable>]
   [-CopyResourceGroupName <String>]
   [-CopyServerName <String>]
   -CopyDatabaseName <String>
   [-AsJob]
   -ComputeGeneration <String>
   -VCore <Int32>
   [-LicenseType <String>]
   [-BackupStorageRedundancy <String>]
   [-ZoneRedundant]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das cmdlet New-AzSqlDatabaseCopy erstellt eine Kopie einer Azure SQL-Datenbank, die die Momentaufnahme der Daten zur aktuellen Zeit verwendet. Verwenden Sie dieses Cmdlet anstelle des cmdlets Start-AzSqlDatabaseCopy, um eine einmalige Datenbankkopie zu erstellen. Dieses Cmdlet gibt das Database-Objekt der Kopie zurück. Hinweis: Verwenden Sie das Cmdlet New-AzSqlDatabaseSecondary, um die Georeplikation für eine Datenbank zu konfigurieren. Dieses Cmdlet wird auch vom SQL Server Stretch Database-Dienst in Azure unterstützt.

Beispiele

Beispiel 1

Erstellt eine Kopie einer SQL-Datenbank, die die Momentaufnahme zur aktuellen Zeit verwendet. (automatisch generiert)

PowerShell 
New-AzSqlDatabaseCopy -CopyDatabaseName <String> -CopyResourceGroupName <String> -CopyServerName <String> -DatabaseName db1 -ResourceGroupName MyResourceGroup -ServerName s1

Beispiel 2

Erstellt eine Kopie einer SQL-Datenbank, die die Momentaufnahme zur aktuellen Zeit verwendet. (automatisch generiert)

PowerShell 
New-AzSqlDatabaseCopy -CopyDatabaseName <String> -CopyResourceGroupName <String> -CopyServerName <String> -DatabaseName db1 -ResourceGroupName MyResourceGroup -ServerName s1 -ServiceObjectiveName 'S1'

Parameter

-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

-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

-ComputeGeneration

Die Berechnungsgenerierung, die der neuen Kopie zugewiesen werden soll.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-CopyDatabaseName

Gibt den Namen der SQL-Datenbankkopie an.

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

-CopyResourceGroupName

Gibt den Namen der Azure-Ressourcengruppe an, in der die Kopie zugewiesen werden soll.

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

-CopyServerName

Gibt den Namen des SQL Server an, der die Kopie hosten soll.

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

-DatabaseName

Gibt den Namen der zu kopierenden SQL-Datenbank an.

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

-ElasticPoolName

Gibt den Namen des elastischen Pools an, in dem die Kopie zugewiesen werden soll.

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

-EncryptionProtector

Der Verschlüsselungsschutzschlüssel für die SQL-Datenbankkopie.

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

-KeyList

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

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, die die zu kopierende Datenbank enthält.

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

-ServerName

Gibt den Namen des SQL Server an, der die zu kopierende Datenbank enthält.

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

-ServiceObjectiveName

Gibt den Namen des Dienstziels an, das der Kopie zugewiesen werden soll.

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

-Tags

Gibt die Schlüsselwertpaare in Form einer Hashtabelle an, die der Azure SQL-Datenbankkopie 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-Datenbankkopie.

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

-VCore

Die Vcore-Nummern der Azure Sql-Datenbankkopie.

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

-WhatIf

Zeigt, was passiert, 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

Ausgaben