Set-AzureRmSqlElasticPool

  • Referenz
Modul:
AzureRM.Sql

Ändert die Eigenschaften eines elastischen Datenbankpools in Azure SQL-Datenbank.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Set-AzureRmSqlElasticPool
   [-ElasticPoolName] <String>
   [-Edition <String>]
   [-Dtu <Int32>]
   [-StorageMB <Int32>]
   [-DatabaseDtuMin <Int32>]
   [-DatabaseDtuMax <Int32>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-LicenseType <String>]
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmSqlElasticPool
   [-ElasticPoolName] <String>
   [-Edition <String>]
   [-StorageMB <Int32>]
   [-VCore <Int32>]
   [-ComputeGeneration <String>]
   [-DatabaseVCoreMin <Double>]
   [-DatabaseVCoreMax <Double>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-LicenseType <String>]
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureRmSqlElasticPool legt Eigenschaften für einen elastischen Pool in Azure SQL-Datenbank fest. Dieses Cmdlet kann die eDTUs pro Pool (Dtu), die maximale Speichergröße pro Pool (StorageMB), maximale eDTUs pro Datenbank (DatabaseDtuMax) und mindestens eDTUs pro Datenbank (DatqabaseDtuMin) ändern. Mehrere Parameter (-Dtu, -DatabaseDtuMin und -DatabaseDtuMax) erfordern den festzulegenden Wert aus der Liste der gültigen Werte für diesen Parameter. Beispielsweise kann "-DatabaseDtuMax" für einen Standard 100 eDTU-Pool nur auf 10, 20, 50 oder 100 festgelegt werden. Ausführliche Informationen zu den gültigen Werten finden Sie in der Tabelle für Ihren spezifischen Größenpool in elastischen Pools.

Beispiele

Beispiel 1: Ändern von Eigenschaften für einen elastischen Pool

PS C:\>Set-AzureRmSqlDatabaseElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Dtu 1000 -DatabaseDtuMax 100 -DatabaseDtuMin 20
ResourceId        : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/resourcegroup01/providers/Microsoft.Sql/servers/Server01/elasticPools/ElasticPool01
ResourceGroupName : ResourceGroup01
ServerName        : Server01
ElasticPoolName   : ElasticPool01
Location          : Central US
CreationDate      : 8/26/2015 10:00:17 PM
State             : Ready
Edition           : Standard
Dtu               : 200
DatabaseDtuMax    : 100
DatabaseDtuMin    : 20
StorageMB         : 204800
Tags              :

Mit diesem Befehl werden Die Eigenschaften für einen elastischen Pool namens elasticpool01 geändert. Der Befehl legt die Anzahl der DTUs für den elastischen Pool auf 1000 fest und legt die minimale und maximale DTUs fest.

Beispiel 2: Ändern der maximalen Speichergröße eines elastischen Pools

PS C:\>Set-AzureRmSqlDatabaseElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -StorageMB 2097152
ResourceId        : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/resourcegroup01/providers/Microsoft.Sql/servers/Server01/elasticPools/ElasticPool01
ResourceGroupName : ResourceGroup01
ServerName        : Server01
ElasticPoolName   : ElasticPool01
Location          : Central US
CreationDate      : 8/26/2015 10:00:17 PM
State             : Ready
Edition           : Premium
Dtu               : 200
DatabaseDtuMax    : 100
DatabaseDtuMin    : 20
StorageMB         : 2097152
Tags              :

Mit diesem Befehl werden Die Eigenschaften für einen elastischen Pool namens elasticpool01 geändert. Der Befehl legt den maximalen Speicher für einen elastischen Pool auf 2 TB fest.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

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

-ComputeGeneration

Die zuzuweisende Berechnungsgenerierung.

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

-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

-DatabaseDtuMax

Gibt die maximale Anzahl von DTUs an, die jede einzelne Datenbank im Pool nutzen kann. Ausführliche Informationen zu den gültigen Werten finden Sie in der Tabelle für Ihren spezifischen Größenpool in elastischen Pools. Die Standardwerte für verschiedene Editionen sind wie folgt:

  • Basic. 5 DTUs
  • Standard. 100 DTUs
  • Premium: 125 DTUs
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseDtuMin

Gibt die Mindestanzahl der DTUs an, die der elastische Pool für alle Datenbanken im Pool garantiert. Ausführliche Informationen zu den gültigen Werten finden Sie in der Tabelle für Ihren spezifischen Größenpool in elastischen Pools. Der Standardwert ist 0 (null).

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

-DatabaseVCoreMax

Die maxmium VCore-Nummer einer beliebigen SqlAzure-Datenbank kann im Pool verwendet werden.

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

-DatabaseVCoreMin

Die minimale VCore-Nummer jeder SqlAzure-Datenbank kann im Pool verwendet werden.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Dtu

Gibt die Gesamtzahl der gemeinsam genutzten DTUs für den elastischen Pool an. Ausführliche Informationen zu den gültigen Werten finden Sie in der Tabelle für Ihren spezifischen Größenpool in elastischen Pools. Die Standardwerte für verschiedene Editionen sind wie folgt:

  • Basic. 100 DTUs
  • Standard. 100 DTUs
  • Premium: 125 DTUs
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Edition

Gibt die Edition des Azure SQL-Datenbank für den elastischen Pool an. Sie können die Edition nicht ändern. Zulässige Werte für diesen Parameter:

  • Keine
  • Basic
  • Standard
  • Premium
  • DataWarehouse
  • Kostenlos
  • Ziehen
  • Universell
  • BusinessCritical
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

Gibt den Namen des elastischen Pools an.

Type:String
Aliases:Name
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LicenseType

Der Lizenztyp für die Azure SQL-Datenbank.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, der der elastische Pool zugewiesen ist.

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

-ServerName

Gibt den Namen des Servers an, der den elastischen Pool hosten soll.

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

-StorageMB

Gibt den Speichergrenzwert in Megabyte für den elastischen Pool an. Weitere Informationen finden Sie im Cmdlet New-AzureRmSqlElasticPool.

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

-Tags

Gibt ein Wörterbuch mit Schlüssel-Wert-Paaren an, das dieses Cmdlet dem elastischen Pool in Form einer Hashtabelle zuordnet. Beispiel: @{key0="value0";"key 1"=$null;key2="value2"}

Type:Hashtable
Aliases:Tag
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VCore

Die Gesamtanzahl der freigegebenen Vcore für den Sql Azure Elastic Pool.

Type:Int32
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

-ZoneRedundant

Die Zonenredundanz, die dem Azure Sql Elastic Pool zugeordnet werden soll

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

Eingaben

String

Ausgaben

AzureSqlElasticPoolModel