Set-AzureSqlDatabase

Referenz

Modul:: Azure

Legt Eigenschaften für eine Azure SQL-Datenbank fest.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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-Datenbankobjekt über die Pipeline übergeben. Sie können den Server anhand des Namens angeben oder einen Azure SQL-Datenbankserververbindungskontext ü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 20

In diesem Beispiel wird die Größe der Datenbank mit dem Namen "Database01" auf 20 GB im Azure SQL-Datenbankserververbindungskontext $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 20

In 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.

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

-ConnectionContext

Gibt den Verbindungskontext eines Servers an.

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

-Database

Gibt ein Objekt an, das die Azure SQL-Datenbank darstellt, die dieses Cmdlet ändert.

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

-DatabaseName

Gibt den Namen der Datenbank an, die dieses Cmdlet ändert.

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

-Edition

Gibt die neue Edition für die Azure SQL-Datenbank an. Gültige Werte sind:

Keine
Web
Business
Basic
Standard
Premium

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

-Force

Ermöglicht die Ausführung der Aktion, ohne Sie zur Bestätigung aufzufordern.

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

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

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

-NewDatabaseName

Gibt den neuen Namen der Datenbank an.

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

-PassThru

Gibt die aktualisierte Azure SQL-Datenbank zurück.

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

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

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

-ServerName

Gibt den Namen des Servers an, der die Datenbank enthält, die dieses Cmdlet ändert.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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-Datenbankupdates V12 (Vorschau). Weitere Informationen finden Sie unter Neuigkeiten in der Azure SQL-Datenbank V12 Previewhttps://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.

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

-Sync

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	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.

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

Eingaben

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Ausgaben