New-AzureSqlDatabaseServerContext
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