Get-AzureSqlDatabase

Referência

Módulo:: Azure

Recupera um ou mais bancos de dados.

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

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

O cmdlet Get-AzureSqlDatabase recupera uma ou mais instâncias de um Banco de Dados SQL do Azure de um servidor do Banco de Dados SQL do Azure. Você pode especificar o servidor com um contexto de conexão de servidor do Banco de Dados SQL do Azure que você cria usando o cmdlet New-AzureSqlDatabaseServerContext . Ou, se você especificar o nome do servidor do Banco de Dados SQL do Azure, o cmdlet usará as informações de assinatura atuais do Azure para autenticar a solicitação para acessar o servidor.

Se você não especificar um banco de dados, o cmdlet Get-AzureSqlDatabase retornará todos os bancos de dados do servidor especificado.

Recuperando bancos de dados restaurados descartados:

Recupere bancos de dados descartados restauráveis usando o parâmetro RestorableDroped . Para retornar todos os bancos de dados restaurados descartados, use o parâmetro RestorableDropped sem DatabaseName e DatabaseDeletionDate. Para retornar um banco de dados restaurado descartado específico, use o parâmetro RestorableDropped com os parâmetros DatabaseName e DatabaseDeletionDate . Ao recuperar um banco de dados descartado restaurável específico usando o parâmetro DatabaseName, você também deve incluir o parâmetro DatabaseDeletionDate e o valor DatabaseDeletionDate especificado deve incluir milissegundos para corresponder ao banco de dados desejado.

O cmdlet Get-AzureSqlDatabase retorna todos os bancos de dados descartados restauráveis em um servidor ou um banco de dados específico que corresponde a DatabaseName e DatabaseDeletionDate. Para retornar bancos de dados descartados restauráveis que satisfaçam critérios diferentes, como todos os bancos de dados descartados restauráveis de um nome específico, você deve retornar todos os bancos de dados descartados restauráveis e, em seguida, filtrar os resultados no cliente.

Exemplos

Exemplo 1: Recuperar todos os bancos de dados em um servidor

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

Este comando recupera todos os bancos de dados no servidor chamado lpqd0zbr8y.

Exemplo 2: Recuperar todos os bancos de dados descartados restauráveis em um servidor

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

Este comando recupera todos os bancos de dados descartados restauráveis no servidor chamado lpqd0zbr8y.

Exemplo 3: Recuperar um banco de dados de um servidor especificado por um contexto de conexão

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

Este comando recupera o banco de dados chamado Database01 do servidor especificado pelo $Context de contexto de conexão.

Exemplo 4: Armazenar um objeto de banco de dados em uma variável

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

Este comando recupera o banco de dados chamado Database01 do servidor chamado lpqd0zbr8y. O comando armazena o objeto de banco de dados na variável $Database 01.

Exemplo 5: Recuperar um banco de dados restaurado descartado

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

Este comando recupera o banco de dados restaurador descartado chamado Database01 que foi excluído em 9/11/2012 do servidor chamado lpqd0zbr8y. Esse comando armazena os resultados na variável $DroppedDB.

Exemplo 6: Recuperar todos os bancos de dados restaurados em um servidor e filtrar os resultados

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

Esse comando recupera todos os bancos de dados descartados restauráveis no servidor chamado lpqd0zbr8y e, em seguida, filtra os resultados somente para os bancos de dados chamados ContactDB.

Parâmetros

-ConnectionContext

Especifica o contexto de conexão de um servidor do qual recuperar um banco de dados.

Type:	IServerDataServiceContext
Aliases:	Context
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Database

Especifica um objeto que representa o banco de dados que esse cmdlet recupera.

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

-DatabaseDeletionDate

Especifica a data e a hora de uma exclusão. Se você especificar o parâmetro RestorableDroped , especifique esse parâmetro para recuperar um banco de dados restaurado descartado com base na data e hora de exclusão.

O parâmetro DatabaseDeletionDate deve incluir milissegundos para corresponder à hora do banco de dados desejado. Especificar um valor sem milissegundos faz com que o banco de dados não seja encontrado.

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

-DatabaseName

Especifica o nome do banco de dados que esse cmdlet recupera.

Type:	String
Position:	Named
Default value:	None
Required:	False
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

-RestorableDropped

Indica que esse cmdlet retorna objetos RestorableDroppedDatabase em vez de objetos Database . Você pode usar o parâmetro DatabaseDeletionDate para selecionar um banco de dados descartado restaurável específico.

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

-RestorableDroppedDatabase

Especifica um objeto que representa o banco de dados restaurado descartado que esse cmdlet recupera.

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

-ServerName

Especifica o nome do servidor que contém o banco de dados recuperado por esse cmdlet. O cmdlet usa a assinatura atual do Azure para acessar o servidor.

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

Entradas

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

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

Saídas

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

Esse cmdlet retornará um objeto Database se você não especificar o parâmetro RestorableDroped .

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

Esse cmdlet retorna um objeto RestorableDroppedDatabase se você especificar o parâmetro RestorableDroped .