Set-AzureRmSqlDatabase

Odwołanie

Moduł:: AzureRM.Sql

Ustawia właściwości bazy danych lub przenosi istniejącą bazę danych do elastycznej puli.

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-AzureRmSqlDatabase
   [-DatabaseName] <String>
   [-MaxSizeBytes <Int64>]
   [-Edition <String>]
   [-RequestedServiceObjectiveName <String>]
   [-ElasticPoolName <String>]
   [-ReadScale <DatabaseReadScale>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-AsJob]
   [-LicenseType <String>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmSqlDatabase
   [-DatabaseName] <String>
   [-MaxSizeBytes <Int64>]
   [-Edition <String>]
   [-ReadScale <DatabaseReadScale>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-AsJob]
   [-VCore <Int32>]
   [-ComputeGeneration <String>]
   [-LicenseType <String>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmSqlDatabase
   [-DatabaseName] <String>
   -NewName <String>
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureRmSqlDatabase ustawia właściwości bazy danych w usłudze Azure SQL Database. To polecenie cmdlet może modyfikować warstwę usługi (Edition), poziom wydajności (RequestedServiceObjectiveName) i maksymalny rozmiar magazynu (MaxSizeBytes) dla bazy danych. Ponadto można określić parametr ElasticPoolName , aby przenieść bazę danych do elastycznej puli. Jeśli baza danych znajduje się już w elastycznej puli, możesz użyć parametru RequestedServiceObjectiveName , aby przenieść bazę danych z elastycznej puli i na poziom wydajności dla pojedynczych baz danych.

Przykłady

Przykład 1. Aktualizowanie bazy danych do bazy danych w warstwie Standardowa S2

PS C:\>Set-AzureRmSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "Standard" -RequestedServiceObjectiveName "S2"
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   : S2
RequestedServiceObjectiveId   : 455330e1-00cd-488b-b5fa-177c226f28b7
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
Tags                          :

To polecenie aktualizuje bazę danych o nazwie Database01 do bazy danych S2 w warstwie Standardowa na serwerze o nazwie Server01.

Przykład 2. Dodawanie bazy danych do elastycznej puli

PS C:\>Set-AzureRmSqlDatabase -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                          :

To polecenie dodaje bazę danych o nazwie Database01 do elastycznej puli o nazwie ElasticPool01 hostowanej na serwerze o nazwie Server01.

Przykład 3. Modyfikowanie maksymalnego rozmiaru magazynu bazy danych

PS C:\>Set-AzureRmSqlDatabase -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                          :

To polecenie aktualizuje bazę danych o nazwie Database01, aby ustawić maksymalny rozmiar na 1 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

-DatabaseName

Określa nazwę bazy danych.

Typ:	String
Aliasy:	Name
Position:	2
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
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

-Edition

Określa edycję bazy danych. 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, w której ma być przeniesiona baza danych.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
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

-MaxSizeBytes

Maksymalny rozmiar usługi Azure SQL Database w bajtach.

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

-NewName

Nowa nazwa, na która ma być zmieniona nazwa bazy danych.

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

-ReadScale

Opcja skalowania odczytu do przypisania do usługi Azure SQL Database. (Włączone/Wyłączone)

Typ:	DatabaseReadScale
Dopuszczalne wartości:	Disabled, Enabled
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RequestedServiceObjectiveName

Określa nazwę celu usługi, który ma zostać przypisany do bazy danych. Aby uzyskać informacje na temat celów usługi, zobacz Warstwy usług i Poziomy wydajności usługi Azure SQL Database w bibliotece sieci deweloperów firmy Microsoft.

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

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 bazę danych.

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

-Tags

Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$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

Numer rdzeni wirtualnych dla bazy danych Azure Sql Database

Typ:	Int32
Aliasy:	Capacity
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 usługą Azure Sql Database

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

AzureSqlDatabaseModel

Udostępnij za pośrednictwem

Set-AzureRmSqlDatabase

Składnia

Opis

Przykłady

Przykład 1. Aktualizowanie bazy danych do bazy danych w warstwie Standardowa S2

Przykład 2. Dodawanie bazy danych do elastycznej puli

Przykład 3. Modyfikowanie maksymalnego rozmiaru magazynu bazy danych

Parametry

-AsJob

-ComputeGeneration

-Confirm

-DatabaseName

-DefaultProfile

-Edition

-ElasticPoolName

-LicenseType

-MaxSizeBytes

-NewName

-ReadScale

-RequestedServiceObjectiveName

-ResourceGroupName

-ServerName

-Tags

-VCore

-WhatIf

-ZoneRedundant

Dane wejściowe

Dane wyjściowe

Dodatkowe zasoby

Udostępnij za pośrednictwem

Set-AzureRmSqlDatabase

Składnia

Opis

Przykłady

Przykład 1. Aktualizowanie bazy danych do bazy danych w warstwie Standardowa S2

Przykład 2. Dodawanie bazy danych do elastycznej puli

Przykład 3. Modyfikowanie maksymalnego rozmiaru magazynu bazy danych

Parametry

-AsJob

-ComputeGeneration

-Confirm

-DatabaseName

-DefaultProfile

-Edition

-ElasticPoolName

-LicenseType

-MaxSizeBytes

-NewName

-ReadScale

-RequestedServiceObjectiveName

-ResourceGroupName

-ServerName

-Tags

-VCore

-WhatIf

-ZoneRedundant

Dane wejściowe

Dane wyjściowe

Linki powiązane

Dodatkowe zasoby