Compartilhar via

New-AzureSqlDatabaseServerContext

  • Referência
Módulo:
Azure

Cria um contexto de conexão de servidor.

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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

Description

O cmdlet New-AzureSqlDatabaseServerContext cria um contexto de conexão do servidor do Banco de Dados SQL do Azure. Use a autenticação do SQL Server para criar um contexto de conexão com um servidor do Banco de dados SQL usando as credenciais especificadas. Você pode especificar o servidor do Banco de dados SQL por nome, pelo nome totalmente qualificado ou por URL. Para obter uma credencial, use o cmdlet Get-Credential que solicita que você especifique o nome de usuário e a senha.

Use o cmdlet New-AzureSqlDatabaseServerContext com autenticação baseada em certificado para criar um contexto de conexão com o servidor do Banco de dados SQL especificado usando os dados de assinatura do Azure especificados. Você pode especificar o servidor do Banco de dados SQL pelo nome ou pelo nome totalmente qualificado. Você pode especificar os dados da assinatura como um parâmetro ou eles podem ser recuperados da assinatura atual do Azure. Use o cmdlet Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx para selecionar a assinatura atual do Azure.

Exemplos

Exemplo 1: Criar um contexto usando a autenticação do 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"

Este exemplo usa a autenticação do SQL Server.

O primeiro comando solicita credenciais de administrador do servidor e armazena as credenciais na variável $Credential.

O segundo comando se conecta ao servidor do Banco de dados SQL chamado lpqd0zbr8y usando $Credential.

O comando final cria um banco de dados chamado Database17 no servidor que faz parte do contexto em $Context.

Exemplo 2: Criar um contexto usando a autenticação baseada em certificado

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

Este exemplo usa a autenticação baseada em certificado.

Os dois primeiros comandos atribuem valores às variáveis $SubscriptionId e $Thumbprint.

O terceiro comando obtém o certificado identificado pela impressão digital em $Thumbprint e o armazena em $Certificate.

O quarto comando define a assinatura como Subscription07 e o quinto comando seleciona essa assinatura.

O comando final cria um contexto na assinatura atual para o servidor chamado lpqd0zbr8y.

Parâmetros

-Credential

Especifica um objeto de credencial que fornece autenticação do SQL Server para você acessar o servidor.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FullyQualifiedServerName

Especifica o nome de domínio totalmente qualificado (FQDN) para o servidor do Banco de Dados SQL do Azure. Por exemplo, Server02.database.windows.net.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManageUrl

Especifica a URL que esse cmdlet usa para acessar o Portal de Gerenciamento do Banco de Dados SQL do Azure para o servidor.

Tipo:Uri
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServerName

Especifica o nome do servidor de banco de dados.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SubscriptionName

Especifica o nome da assinatura do Azure que esse cmdlet usa para criar o contexto de conexão. Se você não especificar um valor para esse parâmetro, o cmdlet usará a assinatura atual. Execute o cmdlet Select-AzureSubscription para alterar a assinatura atual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UseSubscription

Indica que esse cmdlet usa a assinatura do Azure para criar o contexto de conexão.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

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

Observações

  • Se você autenticar sem especificar um domínio e usar o Windows PowerShell 2.0, o cmdlet Get-Credential retornará uma barra invertida (\) anexada ao nome de usuário, por exemplo, \user. O Windows PowerShell 3.0 não adiciona a barra invertida. Essa barra invertida não é reconhecida pelo parâmetro Credential do cmdlet New-AzureSqlDatabaseServerContext . Para removê-lo, use comandos semelhantes aos seguintes:

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