Set-AzSqlDatabase
Legt Eigenschaften für eine Datenbank fest oder verschiebt eine vorhandene Datenbank in einen Pool für elastische Datenbanken.
Syntax
Set-AzSqlDatabase
[-DatabaseName] <String>
[-MaxSizeBytes <Int64>]
[-Edition <String>]
[-RequestedServiceObjectiveName <String>]
[-ElasticPoolName <String>]
[-ReadScale <DatabaseReadScale>]
[-Tags <Hashtable>]
[-ZoneRedundant]
[-AsJob]
[-LicenseType <String>]
[-ComputeModel <String>]
[-AutoPauseDelayInMinutes <Int32>]
[-MinimumCapacity <Double>]
[-HighAvailabilityReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-SecondaryType <String>]
[-MaintenanceConfigurationId <String>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-KeysToRemove <String[]>]
[-FederatedClientId <Guid>]
[-PreferredEnclaveType <String>]
[-EncryptionProtectorAutoRotation]
[-UseFreeLimit]
[-FreeLimitExhaustionBehavior <String>]
[-ManualCutover]
[-PerformCutover]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzSqlDatabase
[-DatabaseName] <String>
[-MaxSizeBytes <Int64>]
[-Edition <String>]
[-ReadScale <DatabaseReadScale>]
[-Tags <Hashtable>]
[-ZoneRedundant]
[-AsJob]
[-VCore <Int32>]
[-ComputeGeneration <String>]
[-LicenseType <String>]
[-ComputeModel <String>]
[-AutoPauseDelayInMinutes <Int32>]
[-MinimumCapacity <Double>]
[-HighAvailabilityReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-SecondaryType <String>]
[-MaintenanceConfigurationId <String>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-KeysToRemove <String[]>]
[-FederatedClientId <Guid>]
[-PreferredEnclaveType <String>]
[-EncryptionProtectorAutoRotation]
[-UseFreeLimit]
[-FreeLimitExhaustionBehavior <String>]
[-ManualCutover]
[-PerformCutover]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzSqlDatabase
[-DatabaseName] <String>
-NewName <String>
[-AsJob]
[-BackupStorageRedundancy <String>]
[-SecondaryType <String>]
[-MaintenanceConfigurationId <String>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-KeysToRemove <String[]>]
[-FederatedClientId <Guid>]
[-PreferredEnclaveType <String>]
[-EncryptionProtectorAutoRotation]
[-UseFreeLimit]
[-FreeLimitExhaustionBehavior <String>]
[-ManualCutover]
[-PerformCutover]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-AzSqlDatabase legt Eigenschaften für eine Datenbank in Azure SQL-Datenbank fest. Dieses Cmdlet kann die Dienstebene (Edition), die Leistungsstufe (RequestedServiceObjectiveName) und die maximale Speichergröße (MaxSizeBytes) für die Datenbank ändern. Darüber hinaus können Sie den ElasticPoolName-Parameter angeben, um eine Datenbank in einen elastischen Pool zu verschieben. Wenn sich eine Datenbank bereits in einem elastischen Pool befindet, können Sie den Parameter RequestedServiceObjectiveName verwenden, um die Datenbank aus einem elastischen Pool und in eine Leistungsstufe für einzelne Datenbanken zu verschieben.
Beispiele
Beispiel 1: Aktualisieren einer Datenbank auf eine Standard-S0-Datenbank
Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "Standard" -RequestedServiceObjectiveName "S0"
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database01
Location : Central US
DatabaseId : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition : Standard
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 268435456000
Status : Online
CreationDate : 7/3/2015 7:33:37 AM
CurrentServiceObjectiveId : 455330e1-00cd-488b-b5fa-177c226f28b7
CurrentServiceObjectiveName : S0
RequestedServiceObjectiveId : 455330e1-00cd-488b-b5fa-177c226f28b7
RequestedServiceObjectiveName :
ElasticPoolName :
EarliestRestoreDate :
Tags :
Mit diesem Befehl wird eine Datenbank mit dem Namen "Database01" auf einer Standard-S0-Datenbank auf einem Server mit dem Namen "Server01" aktualisiert.
Beispiel 2: Hinzufügen einer Datenbank zu einem elastischen Pool
Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -ElasticPoolName "ElasticPool01"
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database01
Location : Central US
DatabaseId : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition : Standard
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 268435456000
Status : Online
CreationDate : 7/3/2015 7:33:37 AM
CurrentServiceObjectiveId : d1737d22-a8ea-4de7-9bd0-33395d2a7419
CurrentServiceObjectiveName : ElasticPool
RequestedServiceObjectiveId : d1737d22-a8ea-4de7-9bd0-33395d2a7419
RequestedServiceObjectiveName :
ElasticPoolName : elasticpool01
EarliestRestoreDate :
Tags :
Mit diesem Befehl wird dem elastischen Pool "ElasticPool01" eine Datenbank mit dem Namen "Database01" hinzugefügt, die auf dem Server mit dem Namen "Server01" gehostet wird.
Beispiel 3: Ändern der maximalen Speichergröße einer Datenbank
Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -MaxSizeBytes 1099511627776
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database01
Location : Central US
DatabaseId : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition : Standard
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 1099511627776
Status : Online
CreationDate : 8/24/2017 9:00:37 AM
CurrentServiceObjectiveId : 789681b8-ca10-4eb0-bdf2-e0b050601b40
CurrentServiceObjectiveName : S3
RequestedServiceObjectiveId : 789681b8-ca10-4eb0-bdf2-e0b050601b40
RequestedServiceObjectiveName :
ElasticPoolName :
EarliestRestoreDate :
Tags :
Mit diesem Befehl wird eine Datenbank namens "Database01" aktualisiert, um die maximale Größe auf 1 TB festzulegen.
Beispiel 4: Aktualisieren einer vorhandenen Allgemeinen Datenbank auf die Hyperscale-Dienstebene
Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "Hyperscale" -RequestedServiceObjectiveName "HS_Gen5_2"
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database01
Location : Central US
DatabaseId : 56246136-839f-4171-80af-4c28142463b1
Edition : Hyperscale
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : -1
Status : Online
CreationDate : 12/6/2020 5:34:16 PM
CurrentServiceObjectiveId : 00000000-0000-0000-0000-000000000000
CurrentServiceObjectiveName : HS_Gen5_2
RequestedServiceObjectiveName : HS_Gen5_2
RequestedServiceObjectiveId :
ElasticPoolName :
EarliestRestoreDate : 12/6/2020 5:34:16 PM
Tags : {}
ResourceId : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/servers/Server01/databases/Database01
CreateMode :
ReadScale : Enabled
ZoneRedundant :
Capacity : 2
Family : Gen5
SkuName : HS_Gen5
LicenseType : LicenseIncluded
AutoPauseDelayInMinutes :
MinimumCapacity :
ReadReplicaCount : 1
BackupStorageRedundancy : Geo
Mit diesem Befehl wird eine Datenbank mit dem Namen "Database01" von "General Purpose" auf die Dienstebene "Hyperscale" aktualisiert.
Beispiel 5: Aktualisieren des bevorzugten Enklaventyps einer Datenbank auf VBS
Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -PreferredEnclaveType "VBS"
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database01
Location : Central US
DatabaseId : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition : Standard
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 1099511627776
Status : Online
CreationDate : 8/24/2017 9:00:37 AM
CurrentServiceObjectiveId : 789681b8-ca10-4eb0-bdf2-e0b050601b40
CurrentServiceObjectiveName : S3
RequestedServiceObjectiveId : 789681b8-ca10-4eb0-bdf2-e0b050601b40
PreferredEnclaveType : VBS
RequestedServiceObjectiveName :
ElasticPoolName :
EarliestRestoreDate :
Tags :
Mit diesem Befehl wird eine Datenbank aktualisiert, um die VBS-Enklave zu konfigurieren.
Parameter
-AsJob
Cmdlet im Hintergrund ausführen
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoPauseDelayInMinutes
Die automatische Pausenverzögerung in Minuten für Die Datenbank (nur serverlos), -1 zum Deaktivieren
Typ: | Int32 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupStorageRedundancy
Die Sicherungsspeicherredundanz, die zum Speichern von Sicherungen für die SQL-Datenbank verwendet wird. Optionen sind: Lokal, Zone, Geo und GeoZone. Informationen zu den optionen, die von den einzelnen Editionen der Datenbank unterstützt werden, finden Sie unter Get-AzSqlCapability.
Typ: | String |
Zulässige Werte: | Local, Zone, Geo, GeoZone |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputeGeneration
Die zuzuweisende Berechnungsgenerierung.
Typ: | String |
Aliases: | Family |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputeModel
Berechnetes Modell der Azure SQL-Datenbank. Serverlos oder bereitgestellt
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseName
Gibt den Namen der Datenbank an.
Typ: | String |
Aliases: | Name |
Position: | 2 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Edition
Gibt die Edition für die Datenbank an. Zulässige Werte für diesen Parameter:
- Keine
- Basic
- Standard
- Premium
- DataWarehouse
- Kostenlos
- Stretch
- Universell
- Hyperscale
- BusinessCritical
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ElasticPoolName
Gibt den Namen des elastischen Pools an, in dem die Datenbank verschoben werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionProtector
Der Verschlüsselungsschutzschlüssel für SQL-Datenbank.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionProtectorAutoRotation
Der Status der automatischen Drehung des AKV-Schlüssels
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FreeLimitExhaustionBehavior
Erschöpfungsverhalten der datenbank mit freiem Grenzwert.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HighAvailabilityReplicaCount
Die Anzahl der readonly sekundären Replikate, die der Datenbank zugeordnet sind. Nur für Hyperscale Edition.
Typ: | Int32 |
Aliases: | ReadReplicaCount |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeyList
Die Liste der AKV-Schlüssel für die SQL-Datenbank.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeysToRemove
Die Liste der AKV-Schlüssel, die aus dem SQL-Datenbank entfernt werden sollen.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseType
Der Lizenztyp für die Azure SQL-Datenbank. Dabei sind folgende Werte möglich:
- BasePrice – Azure-Hybridvorteil (AHB) ermäßigte Preise für vorhandene SQL Server-Lizenzbesitzer werden angewendet. Der Datenbankpreis wird für vorhandene SQL Server-Lizenzbesitzer reduziert.
- LicenseIncluded – Azure-Hybridvorteil (AHB) Rabattpreise für vorhandene SQL Server-Lizenzbesitzer werden nicht angewendet. Der Datenbankpreis umfasst eine neue SQL Server-Lizenzkosten.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaintenanceConfigurationId
Die Wartungskonfigurations-ID für die SQL-Datenbank.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManualCutover
Verwenden Sie die manuelle Übernahme für die Migration zu Hyperscale.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxSizeBytes
Die maximale Größe des Azure SQL-Datenbank in Byte.
Typ: | Int64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinimumCapacity
Die minimale Kapazität, die die Datenbank immer zugewiesen hat, wenn sie nicht angehalten wird. Nur für serverlose Azure SQL-Datenbanken.
Typ: | Double |
Aliases: | MinVCore, MinCapacity |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Der neue Name, in den die Datenbank umbenannt werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PerformCutover
Trigger cutover for migration to Hyperscale.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredEnclaveType
Der bevorzugte Enklavetyp für die Azure SQL-Datenbank. Mögliche Werte sind Default und VBS.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReadScale
Wenn diese Option aktiviert ist, werden Verbindungen, für die die Anwendungsabsicht in ihrem Verbindungszeichenfolge festgelegt ist, möglicherweise an ein readonly sekundäres Replikat weitergeleitet. Diese Eigenschaft ist nur für Premium- und Unternehmenskritisch-Datenbanken festgelegt.
Typ: | DatabaseReadScale |
Zulässige Werte: | Disabled, Enabled |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequestedServiceObjectiveName
Gibt den Namen des Dienstziels an, das der Datenbank zugewiesen werden soll. Informationen zu Dienstzielen finden Sie unter Azure SQL-Datenbank Dienstebenen und Leistungsstufen in der Microsoft Developer Network Library.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Gibt den Namen der Ressourcengruppe an, der der Server zugewiesen ist.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SecondaryType
Der sekundäre Typ der Datenbank, wenn es sich um eine sekundäre Datenbank handelt. Gültige Werte sind Geo und Named.
Typ: | String |
Zulässige Werte: | Named, Geo |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerName
Gibt den Namen des Servers an, auf dem die Datenbank gehostet wird.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tags
Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}
Typ: | Hashtable |
Aliases: | Tag |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseFreeLimit
Verwenden Sie den kostenlosen Grenzwert für diese Datenbank.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserAssignedIdentityId
Die Liste der vom Benutzer zugewiesenen Identitäten für die SQL-Datenbank.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VCore
Die Vcore-Nummer für die Azure Sql-Datenbank
Typ: | Int32 |
Aliases: | Capacity, MaxVCore, MaxCapacity |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ZoneRedundant
Die Zonenredundanz, die der Azure Sql-Datenbank zugeordnet werden soll
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Ausgaben
Ähnliche Themen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für