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

New-AzureSqlDatabaseServerContext

参考

模块:: Azure

创建服务器连接上下文。

注意

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

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器（ARM）资源。

语法

New-AzureSqlDatabaseServerContext
   -ServerName <String>
   -Credential <PSCredential>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

New-AzureSqlDatabaseServerContext
   [-ServerName <String>]
   -ManageUrl <Uri>
   -Credential <PSCredential>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

New-AzureSqlDatabaseServerContext
   -ServerName <String>
   [-UseSubscription]
   [-SubscriptionName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

New-AzureSqlDatabaseServerContext
   -FullyQualifiedServerName <String>
   -Credential <PSCredential>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

New-AzureSqlDatabaseServerContext
   -FullyQualifiedServerName <String>
   [-UseSubscription]
   [-SubscriptionName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

说明

New-AzureSqlDatabaseServerContext cmdlet 创建Azure SQL 数据库服务器连接上下文。使用 SQL Server 身份验证通过指定的凭据创建到SQL 数据库服务器的连接上下文。可以按名称、完全限定名称或 URL 指定SQL 数据库服务器。若要获取凭据，请使用提示你指定用户名和密码的 Get-Credential cmdlet。

使用具有基于证书的身份验证的 New-AzureSqlDatabaseServerContext cmdlet，使用指定的 Azure 订阅数据创建到指定SQL 数据库服务器的连接上下文。可以按名称或完全限定的名称指定SQL 数据库服务器。可以将订阅数据指定为参数，也可以从当前 Azure 订阅中检索该数据。使用 Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx cmdlet 选择当前的 Azure 订阅。

示例

示例 1：使用 SQL Server 身份验证创建上下文

PS C:\> $Credential = Get-Credential
PS C:\> $Context = New-AzureSqlDatabaseServerContext -ServerName "lpqd0zbr8y" -Credential $Credential
PS C:\> $Database17 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database17" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

此示例使用 SQL Server 身份验证。

第一个命令会提示你输入服务器管理员凭据，并将凭据存储在$Credential变量中。

第二个命令使用 $Credential 连接到名为 lpqd0zbr8y 的 SQL 数据库服务器。

最后一个命令在服务器上创建名为 Database17 的数据库，该数据库是$Context上下文的一部分。

示例 2：使用基于证书的身份验证创建上下文

PS C:\> $SubscriptionId = <Subscription ID>
PS C:\> $Thumbprint = <Certificate Thumbprint>
PS C:\> $Certificate = Get-Item "Cert:\CurrentUser\My\$Thumbprint"
PS C:\> Set-AzureSubscription -SubscriptionName "Subscription07" -SubscriptionId $SubscriptionId -Certificate $Certificate
PS C:\> Select-AzureSubscription -SubscriptionName "Subscription07"
PS C:\> $Context = New-AzureSqlDatabaseServerContext -ServerName "lpqd0zbr8y" -UseSubscription

此示例使用基于证书的身份验证。

前两个命令将值分配给$SubscriptionId和$Thumbprint变量。

第三个命令获取$Thumbprint指纹标识的证书，并将其存储在$Certificate中。

第四个命令将订阅设置为 Subscription07，第五个命令选择该订阅。

最后一个命令在名为 lpqd0zbr8y 的服务器当前订阅中创建上下文。

参数

-Credential

指定一个凭据对象，该对象提供用于访问服务器的 SQL Server 身份验证。

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

-FullyQualifiedServerName

指定Azure SQL 数据库服务器的完全限定域名（FQDN）名称。例如，Server02.database.windows.net。

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

-ManageUrl

指定此 cmdlet 用于访问服务器的 Azure SQL 数据库Management Portal 的 URL。

类型:	Uri
Position:	Named
默认值:	None
必需:	True
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

指定数据库服务器的名称。

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

-SubscriptionName

指定此 cmdlet 用于创建连接上下文的 Azure 订阅的名称。如果未为此参数指定值，则 cmdlet 将使用当前订阅。运行 Select-AzureSubscription cmdlet 以更改当前订阅。

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

-UseSubscription

指示此 cmdlet 使用 Azure 订阅创建连接上下文。

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

输出

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.IServerDataServiceContext

备注

如果在未指定域的情况下进行身份验证，如果使用 Windows PowerShell 2.0，则 Get-Credential cmdlet 将返回用户名前面附加的反斜杠（\），例如 \user。 Windows PowerShell 3.0 不会添加反斜杠。 New-AzureSqlDatabaseServerContext cmdlet 的 Credential 参数无法识别此反斜杠。若要删除它，请使用类似于下面的命令：

PS C:\\\> $Credential = Get-Credential PS C:\\\> $Credential = New-Object -TypeName 'System.Management.Automation.PSCredential' -ArgumentList $Credential.Username.Replace("\",""),$Credential.Password

通过