New-AzureSqlDatabaseServerContext

Referência

Módulo:: Azure

Cria um contexto de conexão de servidor.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Uri
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerName

Especifica o nome do servidor de banco de dados.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UseSubscription

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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