Freigeben über

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 Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>]

Beschreibung

Das Cmdlet "Get-AzureSqlDatabase" ruft eine oder mehrere Instanzen eines Azure SQL-Datenbank von einem Azure SQL-Datenbank-Server ab. Sie können den Server mit einem Azure SQL-Datenbank Serververbindungskontext angeben, den Sie mit dem Cmdlet New-AzureSqlDatabaseServerContext erstellen. Wenn Sie den Servernamen Azure SQL-Datenbank 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.

Typ:IServerDataServiceContext
Aliase:Context
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Database

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

Typ:Database
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DatabaseName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

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

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RestorableDroppedDatabase

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

Typ:RestorableDroppedDatabase
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.