Compartir a través de

Get-AzureSqlDatabase

  • Referencia
Módulo:
Azure

Recupera una o varias bases de datos.

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

Get-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   [-Database <Database>]
   [-DatabaseName <String>]
   [-RestorableDropped]
   [-RestorableDroppedDatabase <RestorableDroppedDatabase>]
   [-DatabaseDeletionDate <DateTime>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSqlDatabase
   -ServerName <String>
   [-Database <Database>]
   [-DatabaseName <String>]
   [-RestorableDropped]
   [-RestorableDroppedDatabase <RestorableDroppedDatabase>]
   [-DatabaseDeletionDate <DateTime>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureSqlDatabase recupera una o varias instancias de una instancia de Azure SQL Database desde un servidor de Azure SQL Database. Puede especificar el servidor con un contexto de conexión de servidor de Azure SQL Database que cree mediante el cmdlet New-AzureSqlDatabaseServerContext . O bien, si especifica el nombre del servidor de Azure SQL Database, el cmdlet usa la información actual de la suscripción de Azure para autenticar la solicitud para acceder al servidor.

Si no especifica una base de datos, el cmdlet Get-AzureSqlDatabase devuelve todas las bases de datos del servidor especificado.

Recuperar bases de datos restaurables quitadas:

Recupere las bases de datos quitadas restaurables mediante el parámetro RestorableDropped . Para devolver todas las bases de datos quitadas restaurables, use el parámetro RestorableDropped sin DatabaseName y DatabaseDeletionDate. Para devolver una base de datos quitada restaurable específica, use el parámetro RestorableDropped con los parámetros DatabaseName y DatabaseDeletionDate . Al recuperar una base de datos quitada restaurable específica mediante el parámetro DatabaseName, también debe incluir el parámetro DatabaseDeletionDate y el valor DatabaseDeletionDate especificado debe incluir milisegundos para que coincida con la base de datos deseada.

El cmdlet Get-AzureSqlDatabase devuelve todas las bases de datos que se pueden restaurar en un servidor o una base de datos específica que coincida con DatabaseName y DatabaseDeletionDate. Para devolver bases de datos quitadas restaurables que cumplan distintos criterios, como todas las bases de datos quitadas restaurables de un nombre específico, debe devolver todas las bases de datos quitadas restaurables y, a continuación, filtrar los resultados en el cliente.

Ejemplos

Ejemplo 1: Recuperar todas las bases de datos de un servidor

PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y"

Este comando recupera todas las bases de datos del servidor denominado lpqd0zbr8y.

Ejemplo 2: Recuperar todas las bases de datos quitadas restaurables en un servidor

PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -RestorableDropped

Este comando recupera todas las bases de datos quitadas restaurables en el servidor denominado lpqd0zbr8y.

Ejemplo 3: Recuperar una base de datos de un servidor especificado por un contexto de conexión

PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"

Este comando recupera la base de datos denominada Database01 del servidor especificado por el contexto de conexión $Context.

Ejemplo 4: Almacenar un objeto de base de datos en una variable

PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"

Este comando recupera la base de datos denominada Database01 del servidor denominado lpqd0zbr8y. El comando almacena el objeto de base de datos en la variable $Database 01.

Ejemplo 5: Recuperar una base de datos quitada restaurable

PS C:\> $DroppedDB = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -DatabaseDeletionDate "2012-11-09T22:59:43.000Z" -RestorableDropped

Este comando recupera la base de datos quitada restaurable denominada Database01 que se eliminó el 11/9/2012 del servidor denominado lpqd0zbr8y. Este comando almacena los resultados en la variable $DroppedDB.

Ejemplo 6: Recuperar todas las bases de datos quitadas restaurables en un servidor y filtrar los resultados

PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -RestorableDropped | Where-Object {$_.Name -eq "ContactDB"}

Este comando recupera todas las bases de datos quitadas restaurables en el servidor denominado lpqd0zbr8y y, a continuación, filtra los resultados solo en las bases de datos denominadas ContactDB.

Parámetros

-ConnectionContext

Especifica el contexto de conexión de un servidor desde el que se va a recuperar una base de datos.

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

-Database

Especifica un objeto que representa la base de datos que recupera este cmdlet.

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

-DatabaseDeletionDate

Especifica la fecha y hora de una eliminación. Si especifica el parámetro RestorableDropped , especifique este parámetro para recuperar una base de datos quitada restaurable basada en la fecha y hora de eliminación.

El parámetro DatabaseDeletionDate debe incluir milisegundos para que coincida con la hora de la base de datos deseada. Si se especifica un valor sin milisegundos, la base de datos no se encuentra.

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

-DatabaseName

Especifica el nombre de la base de datos que recupera este cmdlet.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
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

-RestorableDropped

Indica que este cmdlet devuelve objetos RestorableDroppedDatabase en lugar de objetos Database . Puede usar el parámetro DatabaseDeletionDate para seleccionar una base de datos que se puede restaurar específica.

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

-RestorableDroppedDatabase

Especifica un objeto que representa la base de datos quitada restaurable que recupera este cmdlet.

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

-ServerName

Especifica el nombre del servidor que contiene la base de datos que recupera este cmdlet. El cmdlet usa la suscripción actual de Azure para acceder al servidor.

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

Entradas

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestorableDroppedDatabase

Salidas

IEnumerable\<Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database\>

Este cmdlet devuelve un objeto Database si no especifica el parámetro RestorableDropped .

IEnumerable\<Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestorableDroppedDatabase\>

Este cmdlet devuelve un objeto RestorableDroppedDatabase si especifica el parámetro RestorableDropped .