Partilhar via

New-AzureSqlDatabaseServerContext

  • Referência
Módulo:
Azure

Cria um contexto de conexão de servidor.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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 de 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 no $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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServerName

Especifica o nome do servidor de banco de dados.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-UseSubscription

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

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

Notas

  • 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