Udostępnij za pośrednictwem


Set-AzureRmSqlElasticPool

Modyfikuje właściwości elastycznej puli baz danych w usłudze Azure SQL Database.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Set-AzureRmSqlElasticPool ustawia właściwości elastycznej puli w usłudze Azure SQL Database. To polecenie cmdlet może modyfikować jednostki eDTU na pulę (Dtu), maksymalny rozmiar magazynu na pulę (StorageMB), maksymalną liczbę jednostek eDTU na bazę danych (DatabaseDtuMax) i minimalną liczbę jednostek eDTU na bazę danych (DatqabaseDtuMin). Kilka parametrów (-Dtu, -DatabaseDtuMin i -DatabaseDtuMax) wymaga ustawienia wartości z listy prawidłowych wartości dla tego parametru. Na przykład - DatabaseDtuMax dla puli Standardowa 100 eDTU można ustawić tylko na 10, 20, 50 lub 100. Aby uzyskać szczegółowe informacje na temat prawidłowych wartości, zobacz tabelę dla określonej puli rozmiarów w pulach elastycznych.

Przykłady

Przykład 1. Modyfikowanie właściwości puli elastycznej

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              :

To polecenie modyfikuje właściwości puli elastycznej o nazwie elasticpool01. Polecenie ustawia liczbę jednostek DTU dla elastycznej puli na 1000 i ustawia minimalną i maksymalną liczbę jednostek DTU.

Przykład 2. Modyfikowanie maksymalnego rozmiaru magazynu elastycznej puli

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              :

To polecenie modyfikuje właściwości puli elastycznej o nazwie elasticpool01. Polecenie ustawia maksymalny magazyn dla elastycznej puli na 2 TB.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ComputeGeneration

Generowanie obliczeń do przypisania.

Typ:String
Aliasy:Family
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DatabaseDtuMax

Określa maksymalną liczbę jednostek DTU, z których może korzystać dowolna pojedyncza baza danych w puli. Aby uzyskać szczegółowe informacje na temat prawidłowych wartości, zobacz tabelę dla określonej puli rozmiarów w pulach elastycznych. Wartości domyślne dla różnych edycji są następujące:

  • Basic. 5 jednostek DTU
  • Standardowa. 100 jednostek DTU
  • Premium. 125 jednostek DTU
Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DatabaseDtuMin

Określa minimalną liczbę jednostek DTU gwarantowanych przez pulę elastyczną dla wszystkich baz danych w puli. Aby uzyskać szczegółowe informacje na temat prawidłowych wartości, zobacz tabelę dla określonej puli rozmiarów w pulach elastycznych. Wartością domyślną jest zero (0).

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DatabaseVCoreMax

Maksymalna liczba rdzeni wirtualnych dowolna baza danych SqlAzure Database może być używana w puli.

Typ:Double
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DatabaseVCoreMin

Minimalna liczba rdzeni wirtualnych używana przez usługę SqlAzure Database w puli.

Typ:Double
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Dtu

Określa łączną liczbę udostępnionych jednostek DTU dla puli elastycznej. Aby uzyskać szczegółowe informacje na temat prawidłowych wartości, zobacz tabelę dla określonej puli rozmiarów w pulach elastycznych. Wartości domyślne dla różnych edycji są następujące:

  • Basic. 100 jednostek DTU
  • Standardowa. 100 jednostek DTU
  • Premium. 125 jednostek DTU
Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Edition

Określa edycję usługi Azure SQL Database dla elastycznej puli. Nie można zmienić wersji. Dopuszczalne wartości tego parametru to:

  • Brak
  • Podstawowa
  • Standardowa (Standard)
  • Premium
  • DataWarehouse
  • Bezpłatna
  • Stretch
  • Ogólnego przeznaczenia
  • BusinessCritical
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ElasticPoolName

Określa nazwę elastycznej puli.

Typ:String
Aliasy:Name
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LicenseType

Typ licencji dla bazy danych Azure Sql Database.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów, do której przypisano pulę elastyczną.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServerName

Określa nazwę serwera, który hostuje pulę elastyczną.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageMB

Określa limit magazynu w megabajtach dla elastycznej puli. Aby uzyskać więcej informacji, zobacz polecenie cmdlet New-AzureRmSqlElasticPool.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tags

Określa słownik par Klucz-wartość, które to polecenie cmdlet kojarzy z pulą elastyczną w postaci tabeli skrótów. Na przykład: @{key0="value0";"key 1"=$null;key2="value2"}.

Typ:Hashtable
Aliasy:Tag
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VCore

Całkowita udostępniona liczba rdzeni wirtualnych dla elastycznej puli Sql Azure.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ZoneRedundant

Nadmiarowość strefy do skojarzenia z elastyczną pulą Azure Sql

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Dane wyjściowe

AzureSqlElasticPoolModel