Set-AzureSqlDatabase
Legt Eigenschaften für einen Azure SQL-Datenbank fest.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.
Syntax
Set-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-DatabaseName <String>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-Database <Database>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureSqlDatabase
-ServerName <String>
-DatabaseName <String>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureSqlDatabase
-ServerName <String>
-Database <Database>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-AzureSqlDatabase legt Eigenschaften für eine Azure SQL-Datenbank fest. Sie können die Datenbank anhand des Namens angeben oder ein Azure SQL-Datenbank-Objekt über die Pipeline übergeben. Sie können den Server anhand des Namens angeben oder einen Azure SQL-Datenbank Serververbindungskontext übergeben. Erstellen Sie einen Verbindungskontext, indem Sie das Cmdlet New-AzureSqlDatabaseServerContext ausführen. Wenn Sie den Server anhand des Namens angeben, verwendet das Cmdlet die aktuellen Azure-Abonnementinformationen, um die Anforderung zu authentifizieren.
Beispiele
Beispiel 1: Ändern der Größe einer Datenbank mithilfe eines Verbindungskontexts
PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20In diesem Beispiel wird die Größe der Datenbank mit dem Namen "Database01" auf 20 GB im Azure SQL-Datenbank Serververbindungskontext $Context geändert.
Beispiel 2: Ändern der Größe einer Datenbank mithilfe eines Servernamens
PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20In diesem Beispiel wird die Größe der Datenbank mit dem Namen "Database01" in den Server mit dem Namen "lpqd0zbr8y" auf 20 GB geändert.
Parameter
-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 |
-ConnectionContext
Gibt den Verbindungskontext eines Servers an.
| Typ: | IServerDataServiceContext |
| Aliase: | Context |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Database
Gibt ein Objekt an, das den Azure SQL-Datenbank darstellt, den dieses Cmdlet ändert.
| Typ: | Database |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-DatabaseName
Gibt den Namen der Datenbank an, die dieses Cmdlet ändert.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Edition
Gibt die neue Edition für die Azure SQL-Datenbank an. Gültige Werte sind:
- Keine
- Web
- Business
- Grundlegend
- Standard
- Premium
| Typ: | DatabaseEdition |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Ermöglicht die Ausführung der Aktion, ohne Sie zur Bestätigung aufzufordern.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MaxSizeBytes
Gibt die neue maximale Größe für die Datenbank in Byte an. Sie können entweder diesen Parameter oder den Parameter MaxSizeGB angeben. Siehe den Parameter "MaxSizeGB " für akzeptable Werte basierend auf der Edition.
| Typ: | Int64 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MaxSizeGB
Gibt die neue maximale Größe für die Datenbank in Gigabyte an. Sie können entweder diesen Parameter oder den Parameter MaxSizeBytes angeben. Die zulässigen Werte unterscheiden sich je nach Edition.
Basic Edition-Werte: 1 oder 2
Standard Edition-Werte: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200 oder 250
Premium Edition-Werte: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200, 250, 300, 400 oder 500
Web Edition-Werte: 1 oder 5
Business Edition-Werte: 10, 20, 30, 40, 50, 100 oder 150
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-NewDatabaseName
Gibt den neuen Namen der Datenbank an.
| Typ: | String |
| Aliase: | NewName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PassThru
Gibt die aktualisierte Azure SQL-Datenbank zurück.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ServerName
Gibt den Namen des Servers an, der die Datenbank enthält, die dieses Cmdlet ändert.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ServiceObjective
Gibt ein Objekt an, das das neue Dienstziel (Leistungsstufe) für diese Datenbank darstellt. Gültige Werte sind:
- Grund: dd6d99bb-f193-4ec1-86f2-43d3bccbc49c
- Standard (S0): f1173c43-91bd-4aaa-973c-54e79e15235b
- Standard (S1): 1b1ebd4d-d903-4baa-97f9-4ea675f5e928
- Standard (S2): 455330e1-00cd-488b-b5fa-177c226f28b7
- *Standard (S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40
- Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d
- Premium (P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0
- Premium (P3): a7c4c615-cfb1-464b-b252-925be0a19446
*Standard (S3) ist Teil des neuesten SQL-Datenbank Update V12 (Vorschau). Weitere Informationen finden Sie unter What's New in the Azure SQL-Datenbank V12 Previewhttps://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.
| Typ: | ServiceObjective |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Sync
| Typ: | SwitchParameter |
| 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 |
Eingaben
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Ausgaben
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database