Dela via

Get-AzureSqlDatabase

  • Referens
Modul:
Azure

Hämtar en eller flera databaser.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

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

Cmdleten Get-AzureSqlDatabase hämtar en eller flera instanser av en Azure SQL Database från en Azure SQL Database-server. Du kan ange servern med en Azure SQL Database-serveranslutningskontext som du skapar med cmdleten New-AzureSqlDatabaseServerContext . Om du anger servernamnet för Azure SQL Database använder cmdleten den aktuella Azure-prenumerationsinformationen för att autentisera begäran om åtkomst till servern.

Om du inte anger någon databas returnerar cmdleten Get-AzureSqlDatabase alla databaser från den angivna servern.

Hämtar återställningsbara borttagna databaser:

Hämta återställningsbara borttagna databaser med parametern RestorableDropped . Om du vill returnera alla återställningsbara borttagna databaser använder du parametern RestorableDropped utan DatabaseName och DatabaseDeletionDate. Om du vill returnera en specifik återställningsbar borttagen databas använder du parametern RestorableDropped med parametrarna DatabaseName och DatabaseDeletionDate . När du hämtar en specifik återställningsbar borttagen databas med hjälp av parametern DatabaseName måste du även inkludera parametern DatabaseDeletionDate och det angivna Värdet DatabaseDeletionDate måste innehålla millisekunder för att matcha den önskade databasen.

Cmdleten Get-AzureSqlDatabase returnerar antingen alla återställningsbara borttagna databaser på en server eller en specifik databas som matchar både DatabaseName och DatabaseDeletionDate. Om du vill returnera återställningsbara borttagna databaser som uppfyller olika kriterier, till exempel alla återställningsbara borttagna databaser med ett specifikt namn, måste du returnera alla återställningsbara borttagna databaser och sedan filtrera resultatet på klienten.

Exempel

Exempel 1: Hämta alla databaser på en server

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

Det här kommandot hämtar alla databaser på servern med namnet lpqd0zbr8y.

Exempel 2: Hämta alla återställningsbara borttagna databaser på en server

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

Det här kommandot hämtar alla återställningsbara borttagna databaser på servern med namnet lpqd0zbr8y.

Exempel 3: Hämta en databas från en server som anges av en anslutningskontext

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

Det här kommandot hämtar databasen Database01 från servern som anges av anslutningskontexten $Context.

Exempel 4: Lagra ett databasobjekt i en variabel

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

Det här kommandot hämtar databasen Database01 från servern med namnet lpqd0zbr8y. Kommandot lagrar databasobjektet i variabeln $Database 01.

Exempel 5: Hämta en återställningsbar borttagen databas

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

Det här kommandot hämtar den återställningsbara borttagna databasen med namnet Database01 som togs bort den 11/9/2012 från servern med namnet lpqd0zbr8y. Det här kommandot lagrar resultatet i variabeln $DroppedDB.

Exempel 6: Hämta alla återställningsbara borttagna databaser på en server och filtrera resultatet

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

Det här kommandot hämtar alla återställningsbara borttagna databaser på servern med namnet lpqd0zbr8y och filtrerar sedan resultatet till endast databaserna med namnet ContactDB.

Parametrar

-ConnectionContext

Anger anslutningskontexten för en server som en databas ska hämtas från.

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

-Database

Anger ett objekt som representerar databasen som den här cmdleten hämtar.

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

-DatabaseDeletionDate

Anger datum och tid för en borttagning. Om du anger parametern RestorableDropped anger du den här parametern för att hämta en återställningsbar borttagen databas baserat på datum och tid för borttagning.

Parametern DatabaseDeletionDate måste innehålla millisekunder för att matcha tiden för den önskade databasen. Om du anger ett värde utan millisekunder går det inte att hitta databasen.

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

-DatabaseName

Anger namnet på databasen som den här cmdleten hämtar.

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

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

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

-RestorableDropped

Anger att den här cmdleten returnerar RestorableDroppedDatabase-objekt i stället för Databasobjekt . Du kan använda parametern DatabaseDeletionDate för att välja en specifik återställningsbar borttagen databas.

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

-RestorableDroppedDatabase

Anger ett objekt som representerar den återställningsbara borttagna databasen som den här cmdleten hämtar.

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

-ServerName

Anger namnet på servern som innehåller databasen som den här cmdleten hämtar. Cmdleten använder den aktuella Azure-prenumerationen för att komma åt servern.

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

Indata

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

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

Utdata

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

Den här cmdleten returnerar ett databasobjekt om du inte anger parametern RestorableDropped .

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

Den här cmdleten returnerar ett RestorableDroppedDatabase-objekt om du anger parametern RestorableDropped .