Compartir a través de

New-AzureSqlDatabaseServerContext

  • Referencia
Módulo:
Azure

Crea un contexto de conexión de servidor.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet New-AzureSqlDatabaseServerContext crea un contexto de conexión del servidor de Azure SQL Database. Use la autenticación de SQL Server para crear un contexto de conexión a un servidor de SQL Database mediante las credenciales especificadas. Puede especificar el servidor de SQL Database por nombre, por el nombre completo o por dirección URL. Para obtener una credencial, use el cmdlet Get-Credential que le pide que especifique el nombre de usuario y la contraseña.

Use el cmdlet New-AzureSqlDatabaseServerContext con autenticación basada en certificados para crear un contexto de conexión al servidor de SQL Database especificado mediante los datos de suscripción de Azure especificados. Puede especificar el servidor de SQL Database por nombre o por el nombre completo. Puede especificar los datos de la suscripción como parámetro o se puede recuperar de la suscripción de Azure actual. Use el cmdlet Select-AzureSubscriptionhttps://msdn.microsoft.com/library/windowsazure/jj152833.aspx para seleccionar la suscripción actual de Azure.

Ejemplos

Ejemplo 1: Creación de un contexto mediante la autenticación de 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"

En este ejemplo se usa la autenticación de SQL Server.

El primer comando le pide las credenciales de administrador del servidor y almacena las credenciales en la variable $Credential.

El segundo comando se conecta al servidor de SQL Database denominado lpqd0zbr8y mediante $Credential.

El comando final crea una base de datos denominada Database17 en el servidor que forma parte del contexto en $Context.

Ejemplo 2: Creación de un contexto mediante la autenticación basada en certificados

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

En este ejemplo se usa la autenticación basada en certificados.

Los dos primeros comandos asignan valores a las variables $SubscriptionId y $Thumbprint.

El tercer comando obtiene el certificado identificado por la huella digital en $Thumbprint y lo almacena en $Certificate.

El cuarto comando establece la suscripción como Subscription07 y el quinto comando selecciona esa suscripción.

El comando final crea un contexto en la suscripción actual para el servidor denominado lpqd0zbr8y.

Parámetros

-Credential

Especifica un objeto de credencial que proporciona autenticación de SQL Server para acceder al servidor.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FullyQualifiedServerName

Especifica el nombre de dominio completo (FQDN) para el servidor de Azure SQL Database. Por ejemplo, Server02.database.windows.net.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ManageUrl

Especifica la dirección URL que usa este cmdlet para acceder al Portal de Azure SQL DatabaseManagement para el servidor.

Tipo:Uri
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServerName

Especifica el nombre del servidor de bases de datos.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SubscriptionName

Especifica el nombre de la suscripción de Azure que usa este cmdlet para crear el contexto de conexión. Si no especifica un valor para este parámetro, el cmdlet usa la suscripción actual. Ejecute el cmdlet Select-AzureSubscription para cambiar la suscripción actual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-UseSubscription

Indica que este cmdlet usa la suscripción de Azure para crear el contexto de conexión.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

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

Notas

  • Si se autentica sin especificar un dominio y, si usa Windows PowerShell 2.0, el cmdlet Get-Credential devuelve una barra diagonal inversa (\) anteponeda al nombre de usuario, por ejemplo, \user. Windows PowerShell 3.0 no agrega la barra diagonal inversa. El parámetro Credential del cmdlet New-AzureSqlDatabaseServerContext no reconoce esta barra diagonal inversa. Para quitarlo, use comandos similares a los siguientes:

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