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.