Get-AzureSqlDatabase

Referenz

Modul:: Azure

Ruft eine oder mehrere Datenbanken ab.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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>]

Beschreibung

Das Cmdlet Get-AzureSqlDatabase ruft eine oder mehrere Instanzen einer Azure SQL-Datenbank von einem Azure SQL-Datenbankserver ab. Sie können den Server mit einem Azure SQL-Datenbankserververbindungskontext angeben, den Sie mit dem Cmdlet New-AzureSqlDatabaseServerContext erstellen. Wenn Sie den Azure SQL-Datenbankservernamen angeben, verwendet das Cmdlet die aktuellen Azure-Abonnementinformationen, um die Anforderung für den Zugriff auf den Server zu authentifizieren.

Wenn Sie keine Datenbank angeben, gibt das Cmdlet Get-AzureSqlDatabase alle Datenbanken vom angegebenen Server zurück.

Abrufen wiederherstellbarer gelöschter Datenbanken:

Rufen Sie wiederherstellbare verworfene Datenbanken mithilfe des Parameters RestorableDropped ab. Um alle wiederherstellbaren gelöschten Datenbanken zurückzugeben, verwenden Sie den Parameter RestorableDropped ohne DatabaseName und DatabaseDeletionDate. Um eine bestimmte wiederherstellbare verworfene Datenbank zurückzugeben, verwenden Sie den Parameter "RestorableDropped " mit den Parametern "DatabaseName " und "DatabaseDeletionDate ". Beim Abrufen einer bestimmten wiederherstellbaren verworfenen Datenbank mithilfe des Parameters "DatabaseName " müssen Sie auch den Parameter "DatabaseDeletionDate " einschließen, und der angegebene Wert "DatabaseDeletionDate " muss Millisekunden enthalten, um der gewünschten Datenbank zu entsprechen.

Das Cmdlet "Get-AzureSqlDatabase" gibt entweder alle wiederhergestellten gelöschten Datenbanken auf einem Server oder eine bestimmte Datenbank zurück, die sowohl "DatabaseName" als auch "DatabaseDeletionDate" entspricht. Um wiederherstellbare verworfene Datenbanken zurückzugeben, die unterschiedliche Kriterien erfüllen, z. B. alle wiederherstellbaren gelöschten Datenbanken mit einem bestimmten Namen, müssen Sie alle wiederherzustellenden verworfenen Datenbanken zurückgeben und dann die Ergebnisse auf dem Client filtern.

Beispiele

Beispiel 1: Abrufen aller Datenbanken auf einem Server

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

Mit diesem Befehl werden alle Datenbanken auf dem Server mit dem Namen lpqd0zbr8y abgerufen.

Beispiel 2: Abrufen aller wiederherstellbaren gelöschten Datenbanken auf einem Server

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

Mit diesem Befehl werden alle wiederhergestellten verworfenen Datenbanken auf dem Server mit dem Namen lpqd0zbr8y abgerufen.

Beispiel 3: Abrufen einer Datenbank von einem Server, der durch einen Verbindungskontext angegeben ist

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

Mit diesem Befehl wird die Datenbank "Database01" vom Server abgerufen, der durch den Verbindungskontext $Context angegeben wird.

Beispiel 4: Speichern eines Datenbankobjekts in einer Variablen

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

Mit diesem Befehl wird die Datenbank "Database01" vom Server mit dem Namen "lpqd0zbr8y" abgerufen. Der Befehl speichert das Datenbankobjekt in der Variablen $Database 01.

Beispiel 5: Abrufen einer wiederherstellbaren verworfenen Datenbank

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

Mit diesem Befehl wird die wiederherstellbare abgelegte Datenbank namens Database01 abgerufen, die am 11.9.2012 vom Server mit dem Namen lpqd0zbr8y gelöscht wurde. Dieser Befehl speichert die Ergebnisse in der variablen $DroppedDB.

Beispiel 6: Abrufen aller wiederhergestellten gelöschten Datenbanken auf einem Server und Filtern der Ergebnisse

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

Dieser Befehl ruft alle wiederhergestellten verworfenen Datenbanken auf dem Server mit dem Namen lpqd0zbr8y ab und filtert die Ergebnisse dann nur auf die Datenbanken namens ContactDB.

Parameter

-ConnectionContext

Gibt den Verbindungskontext eines Servers an, von dem eine Datenbank abgerufen werden soll.

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

-Database

Gibt ein Objekt an, das die Datenbank darstellt, die dieses Cmdlet abruft.

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

-DatabaseDeletionDate

Gibt das Datum und die Uhrzeit eines Löschvorgangs an. Wenn Sie den Parameter RestorableDropped angeben, geben Sie diesen Parameter an, um eine wiederherstellbare verworfene Datenbank basierend auf dem Löschdatum und der Löschzeit abzurufen.

Der Parameter "DatabaseDeletionDate " muss Millisekunden enthalten, um der Uhrzeit der gewünschten Datenbank zu entsprechen. Wenn Sie einen Wert ohne Millisekunden angeben, wird die Datenbank nicht gefunden.

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

-DatabaseName

Gibt den Namen der Datenbank an, die dieses Cmdlet abruft.

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

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

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

-RestorableDropped

Gibt an, dass dieses Cmdlet RestoreableDroppedDatabase-Objekte anstelle von Database-Objekten zurückgibt. Sie können den Parameter "DatabaseDeletionDate " verwenden, um eine bestimmte wiederherstellbare verworfene Datenbank auszuwählen.

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

-RestorableDroppedDatabase

Gibt ein Objekt an, das die wiederherstellbare verworfene Datenbank darstellt, die dieses Cmdlet abruft.

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

-ServerName

Gibt den Namen des Servers an, der die Datenbank enthält, die dieses Cmdlet abruft. Das Cmdlet verwendet das aktuelle Azure-Abonnement für den Zugriff auf den Server.

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

Eingaben

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

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

Ausgaben

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

Dieses Cmdlet gibt ein Database - Objekt zurück, wenn Sie den Parameter RestorableDropped nicht angeben.

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

Dieses Cmdlet gibt ein RestorableDroppedDatabase-Objekt zurück, wenn Sie den Parameter RestorableDropped angeben.