New-AzureSqlDatabase
Erstellt eine Azure SQL-Datenbank.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.
Syntax
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>] Beschreibung
Das Cmdlet New-AzureSqlDatabase erstellt eine Azure SQL-Datenbank. Sie können den Server mithilfe eines Azure SQL-Datenbank Serververbindungskontexts angeben, den Sie mit dem Cmdlet New-AzureSqlDatabaseServerContext erstellen. Wenn Sie den Servernamen angeben, verwendet das Cmdlet die aktuellen Azure-Abonnementinformationen, um die Anforderung für den Zugriff auf den Server zu authentifizieren.
Wenn Sie eine neue Datenbank erstellen, indem Sie einen Azure SQL-Datenbank Server angeben, erstellt das Cmdlet New-AzureSqlDatabase einen temporären Verbindungskontext unter Verwendung des angegebenen Servernamens und der aktuellen Azure-Abonnementinformationen zum Ausführen des Vorgangs.
Beispiele
Beispiel 1: Erstellen einer Datenbank
PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"Mit diesem Befehl wird ein Azure SQL-Datenbank namens "Database1" für den Azure SQL-Datenbank Serververbindungskontext $Context erstellt.
Beispiel 2: Erstellen einer Datenbank im aktuellen Abonnement
PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"In diesem Beispiel wird eine Datenbank namens "Database1" im angegebenen Azure SQL-Datenbank Server mit dem Namen "lpqd0zbr8y" erstellt. Das Cmdlet verwendet die aktuellen Azure-Abonnementinformationen, um die Anforderung für den Zugriff auf den Server zu authentifizieren.
Parameter
-Collation
Gibt eine Sortierung für die neue Datenbank an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ConnectionContext
Gibt den Verbindungskontext eines Servers an, auf dem dieses Cmdlet eine Datenbank erstellt.
| Typ: | IServerDataServiceContext |
| Aliase: | Context |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-DatabaseName
Gibt den Namen der neuen Datenbank an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Edition
Gibt die Edition für die neue Azure SQL-Datenbank an. Gültige Werte sind:
- Keine
- Web
- Business
- Grundlegend
- Standard
- Premium
Der Standardwert ist Web.
| Typ: | DatabaseEdition |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Ermöglicht die Ausführung der Aktion, ohne den Benutzer zur Bestätigung aufzufordern.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MaxSizeBytes
Gibt die maximale Größe der Datenbank in Byte an. Sie können entweder diesen Parameter oder den Parameter MaxSizeGB angeben. In der Beschreibung des MaxSizeGB-Parameters finden Sie auf der Grundlage der Edition akzeptable Werte.
| Typ: | Int64 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MaxSizeGB
Gibt die maximale Größe der 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
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ServerName
Gibt den Namen des Azure SQL-Datenbank Servers an, der die neue Datenbank enthalten soll.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ServiceObjective
Gibt ein Objekt an, das das neue Dienstziel (Leistungsstufe) für diese Datenbank darstellt. Dieser Wert stellt die Ebene der Ressourcen dar, die dieser Datenbank zugewiesen sind. Gültige Werte sind:
Basic: 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-177c26f28b7 *Standard (S3): 789681b8-ca10-4eb0 -bdf2-e0b050601b40 Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d 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-Datenbank Update V12 (Vorschau). Weitere Informationen finden Sie unter What's New in the Azure SQL-Datenbank V12 Previewhttps://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.
| Typ: | ServiceObjective |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Ausgaben
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Hinweise
- Verwenden Sie das Cmdlet Remove-AzureDatabase, um eine Datenbank zu löschen, die von New-AzureSqlDatabase erstellt wurde.