Delen via


Get-AzureSqlDatabase

Hiermee haalt u een of meer databases op.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

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

Met de cmdlet Get-AzureSqlDatabase worden een of meer exemplaren van een Azure SQL Database opgehaald van een Azure SQL Database-server. U kunt de server opgeven met een Azure SQL Database-serververbindingscontext die u maakt met behulp van de cmdlet New-AzureSqlDatabaseServerContext . Als u de naam van de Azure SQL Database-server opgeeft, gebruikt de cmdlet de huidige Azure-abonnementsgegevens om de aanvraag te verifiëren voor toegang tot de server.

Als u geen database opgeeft, retourneert de Cmdlet Get-AzureSqlDatabase alle databases van de opgegeven server.

Herstelbare verwijderde databases ophalen:

Haal verwijderde databases op met behulp van de parameter RestorableDropped . Als u alle verwijderde databases wilt retourneren, gebruikt u de parameter RestorableDropped zonder DatabaseName en DatabaseDeletionDate. Als u een specifieke verwijderde database wilt retourneren, gebruikt u de parameter RestorableDropped met de parameters DatabaseName en DatabaseDeletionDate . Wanneer u een specifieke herstelde database opzoekt met behulp van de parameter DatabaseName , moet u ook de parameter DatabaseDeletionDate opnemen en moet de opgegeven waarde DatabaseDeletionDate milliseconden bevatten om overeen te komen met de gewenste database.

De cmdlet Get-AzureSqlDatabase retourneert alle verwijderde databases op een server of een specifieke database die overeenkomt met zowel DatabaseName als DatabaseDeletionDate. Als u verwijderde databases wilt retourneren die voldoen aan verschillende criteria, zoals alle verwijderde databases met een specifieke naam, moet u alle verwijderde databases retourneren en de resultaten vervolgens filteren op de client.

Voorbeelden

Voorbeeld 1: Alle databases op een server ophalen

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

Met deze opdracht worden alle databases op de server met de naam lpqd0zbr8y opgehaald.

Voorbeeld 2: alle verwijderde databases op een server ophalen die kunnen worden teruggezet

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

Met deze opdracht worden alle verwijderde databases opgehaald op de server met de naam lpqd0zbr8y.

Voorbeeld 3: Een database ophalen van een server die is opgegeven door een verbindingscontext

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

Met deze opdracht wordt de database Database01 opgehaald van de server die is opgegeven door de verbindingscontext $Context.

Voorbeeld 4: Een databaseobject opslaan in een variabele

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

Met deze opdracht wordt de database Database01 opgehaald van de server met de naam lpqd0zbr8y. Met de opdracht wordt het databaseobject opgeslagen in de variabele $Database 01.

Voorbeeld 5: Een restorable verwijderde database ophalen

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

Met deze opdracht wordt de herstelde database met de naam Database01 opgehaald die op 9-11-9-2012 is verwijderd van de server met de naam lpqd0zbr8y. Met deze opdracht worden de resultaten opgeslagen in de variabele $DroppedDB.

Voorbeeld 6: Alle terug te halen verwijderde databases op een server en de resultaten filteren

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

Met deze opdracht worden alle verwijderde databases opgehaald op de server met de naam lpqd0zbr8y en worden de resultaten vervolgens alleen gefilterd op de databases met de naam ContactDB.

Parameters

-ConnectionContext

Hiermee geeft u de verbindingscontext op van een server waaruit een database moet worden opgehaald.

Type:IServerDataServiceContext
Aliases:Context
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Database

Hiermee geeft u een object op dat de database vertegenwoordigt die door deze cmdlet wordt opgehaald.

Type:Database
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseDeletionDate

Hiermee geeft u de datum en tijd van een verwijdering. Als u de parameter RestorableDropped opgeeft, geeft u deze parameter op om een verwijderde database op te halen op basis van de verwijderingsdatum en -tijd.

De parameter DatabaseDeletionDate moet milliseconden bevatten die overeenkomen met de tijd van de gewenste database. Als u een waarde zonder milliseconden opgeeft, wordt de database niet gevonden.

Type:DateTime
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Hiermee geeft u de naam op van de database die door deze cmdlet wordt opgehaald.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-RestorableDropped

Geeft aan dat deze cmdlet restorableDroppedDatabase-objecten retourneert in plaats van databaseobjecten. U kunt de parameter DatabaseDeletionDate gebruiken om een specifieke verwijderde database te selecteren.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-RestorableDroppedDatabase

Hiermee geeft u een object op dat de verwijderde database vertegenwoordigt die door deze cmdlet wordt opgehaald.

Type:RestorableDroppedDatabase
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

Hiermee geeft u de naam op van de server die de database bevat die door deze cmdlet wordt opgehaald. De cmdlet gebruikt het huidige Azure-abonnement om toegang te krijgen tot de server.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

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

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

Uitvoerwaarden

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

Met deze cmdlet wordt een databaseobject geretourneerd als u de parameter RestorableDropped niet opgeeft.

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

Met deze cmdlet wordt een RestorableDroppedDatabase-object geretourneerd als u de parameter RestorableDropped opgeeft.