New-AzureSqlDatabase
Tworzy usługę Azure SQL Database.
Uwaga
Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.
Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.
Składnia
New-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-DatabaseName <String>
[-Collation <String>]
[-Edition <DatabaseEdition>]
[-ServiceObjective <ServiceObjective>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureSqlDatabase
-ServerName <String>
-DatabaseName <String>
[-Collation <String>]
[-Edition <DatabaseEdition>]
[-ServiceObjective <ServiceObjective>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet New-AzureSqlDatabase tworzy bazę danych Azure SQL Database. Serwer można określić przy użyciu kontekstu połączenia serwera usługi Azure SQL Database utworzonego za pomocą polecenia cmdlet New-AzureSqlDatabaseServerContext . Lub, jeśli określisz nazwę serwera, polecenie cmdlet używa bieżących informacji o subskrypcji platformy Azure do uwierzytelniania żądania dostępu do serwera.
Podczas tworzenia nowej bazy danych przez określenie serwera usługi Azure SQL Database polecenie cmdlet New-AzureSqlDatabase tworzy tymczasowy kontekst połączenia przy użyciu określonej nazwy serwera i bieżących informacji o subskrypcji platformy Azure do wykonania operacji.
Przykłady
Przykład 1. Tworzenie bazy danych
PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"
To polecenie tworzy bazę danych Azure SQL Database o nazwie Database1 dla kontekstu połączenia serwera usługi Azure SQL Database $Context.
Przykład 2. Tworzenie bazy danych w bieżącej subskrypcji
PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"
W tym przykładzie tworzona jest baza danych o nazwie Database1 na określonym serwerze usługi Azure SQL Database o nazwie lpqd0zbr8y. Polecenie cmdlet używa bieżących informacji o subskrypcji platformy Azure do uwierzytelniania żądania dostępu do serwera.
Parametry
-Collation
Określa sortowanie dla nowej bazy danych.
Typ: | String |
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 |
-ConnectionContext
Określa kontekst połączenia serwera, na którym to polecenie cmdlet tworzy bazę danych.
Typ: | IServerDataServiceContext |
Aliasy: | Context |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-DatabaseName
Określa nazwę nowej bazy danych.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Edition
Określa edycję nowej usługi Azure SQL Database. Prawidłowe wartości to:
- Brak
- Internet
- Służbowy
- Podstawowa
- Standardowa (Standard)
- Premium
Wartość domyślna to Sieć Web.
Typ: | DatabaseEdition |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Force
Umożliwia wykonanie akcji bez monitowania użytkownika o potwierdzenie.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-MaxSizeBytes
Określa maksymalny rozmiar bazy danych w bajtach. Można określić ten parametr lub parametr MaxSizeGB . Zobacz opis parametru MaxSizeGB , aby uzyskać dopuszczalne wartości na podstawie wersji.
Typ: | Int64 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-MaxSizeGB
Określa maksymalny rozmiar bazy danych w gigabajtach. Można określić ten parametr lub parametr MaxSizeBytes . Dopuszczalne wartości różnią się w zależności od wersji.
Wartości wersji podstawowej: 1 lub 2
Wartości wersji Standard Edition: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200 lub 250
Wartości wersji Premium: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200, 250, 300, 400 lub 500
Wartości wersji internetowej: 1 lub 5
Wartości wersji biznesowej: 10, 20, 30, 40, 50, 100 lub 150
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Profile
Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.
Typ: | AzureSMProfile |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ServerName
Określa nazwę serwera usługi Azure SQL Database, który ma zawierać nową bazę danych.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ServiceObjective
Określa obiekt reprezentujący nowy cel usługi (poziom wydajności) dla tej bazy danych. Ta wartość reprezentuje poziom zasobów przypisanych do tej bazy danych. Prawidłowe wartości to:
Podstawowe: 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 (P1): 7203483a-c4fb-4304-9e9f-9e9f-117c71c904f5d Premium (P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0 Premium (P3): a7c4c615-cfb1-464b-b252-925be0a1946
*Standardowa (S3) jest częścią najnowszej aktualizacji usługi SQL Database w wersji 12 (wersja zapoznawcza). Aby uzyskać więcej informacji, zobacz Co nowego w usłudze Azure SQL Database w wersji 12 (wersja zapoznawcza)https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.
Typ: | ServiceObjective |
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 |
Dane wyjściowe
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Uwagi
- Aby usunąć bazę danych utworzoną przez bazę danych New-AzureSqlDatabase, użyj polecenia cmdlet Remove-AzureSqlDatabase.