你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzureSqlDatabase

创建Azure SQL 数据库。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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

说明

New-AzureSqlDatabase cmdlet 创建Azure SQL 数据库。 可以使用使用 New-AzureSqlDatabaseServerContext cmdlet 创建的Azure SQL 数据库服务器连接上下文来指定服务器。 或者,如果指定服务器名称,cmdlet 将使用当前的 Azure 订阅信息对访问服务器的请求进行身份验证。

通过指定Azure SQL 数据库服务器创建新数据库时,New-AzureSqlDatabase cmdlet 将使用指定的服务器名称和当前的 Azure 订阅信息创建临时连接上下文来执行该操作。

示例

示例 1:创建数据库

PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

此命令为Azure SQL 数据库服务器连接上下文$Context创建名为 Database1 的Azure SQL 数据库。

示例 2:在当前订阅中创建数据库

PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

此示例在名为 lpqd0zbr8y 的指定Azure SQL 数据库服务器中创建名为 Database1 的数据库。 该 cmdlet 使用当前的 Azure 订阅信息对访问服务器的请求进行身份验证。

参数

-Collation

指定新数据库的排序规则。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
Aliases:cf
Position:Named
默认值:False
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionContext

指定此 cmdlet 在其中创建数据库的服务器的连接上下文。

类型:IServerDataServiceContext
Aliases:Context
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseName

指定新数据库的名称。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-Edition

指定新Azure SQL 数据库的版本。 有效值为:

  • Web
  • 业务
  • 基本
  • 标准
  • 高级

默认值为 Web。

类型:DatabaseEdition
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

允许操作完成,而无需提示用户进行确认。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxSizeBytes

指定数据库的最大大小(以字节为单位)。 可以指定此参数或 MaxSizeGB 参数。 有关基于版本的可接受值,请参阅 MaxSizeGB 参数说明。

类型:Int64
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxSizeGB

指定数据库的最大大小(以 GB 为单位)。 可以指定此参数或 MaxSizeBytes 参数。 可接受的值因版本而异。

基本版值:1 或 2

标准版值:1、2、5、10、20、30、40、50、100、150、200 或 250

Premium Edition 值:1、2、5、10、20、30、40、50、100、150、200、250、300、400 或 500

Web 版本值:1 或 5

Business Edition 值:10、20、30、40、50、100 或 150

类型:Int32
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

指定要包含新数据库的Azure SQL 数据库服务器的名称。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-ServiceObjective

指定表示此数据库的新服务目标(性能级别)的对象。 此值表示分配给此数据库的资源级别。 有效值为:

基本:dd6d99bb-f193-4ec1-86f2-43d3bccbc49c Standard (S0): f1173c43-91bd-4aaa-973c-54e79e15235b Standard (S1): 1b1ebd4d-1d903-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-17c71c904f5d Premium (P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0 Premium (P3): a7c4c615-cfb1-464b-b252-925be0a19446

*标准版(S3)是最新SQL 数据库更新 V12(预览版)的一部分。 有关详细信息,请参阅 Azure SQL 数据库 V12 预览版中的新增功能https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.

类型:ServiceObjective
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
Aliases:wi
Position:Named
默认值:False
必需:False
Accept pipeline input:False
Accept wildcard characters:False

输出

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

备注

  • 若要删除由 New-AzureSqlDatabase 创建的数据库,请使用 Remove-AzureSqlDatabase cmdlet。