Partilhar via

Get-AzureSqlDatabase

  • Referência
Módulo:
Azure

Recupera um ou mais bancos de dados.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para 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 de acesso ao 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 descartados restauráveis:

Recupere bancos de dados descartados restauráveis usando o parâmetro RestorableDroped . Para retornar todos os bancos de dados descartados restauráveis, use o parâmetro RestorableDropped sem DatabaseName e DatabaseDeletionDate. Para retornar um banco de dados descartado restaurável 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 especificado DatabaseDeletionDate 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 contexto de conexão $Context.

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 descartado restaurável

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

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

Exemplo 6: Recuperar todos os bancos de dados descartados restauráveis em um servidor e filtrar os resultados

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

Este comando recupera todos os bancos de dados descartados restauráveis no servidor chamado lpqd0zbr8y e, em seguida, filtra os resultados apenas 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 recuperado por esse cmdlet.

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 RestorableDrop, especifique esse parâmetro para recuperar um banco de dados descartado restaurável com base na data e hora de exclusão.

O parâmetro DatabaseDeletionDate deve incluir milissegundos para corresponder à hora do banco de dados desejado. A especificação de um valor sem milissegundos resulta na não localização do banco de dados.

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 é lido. 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 descartado restaurável 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 que esse cmdlet recupera. 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\>

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

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

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