Udostępnij za pośrednictwem

Get-AzureSqlDatabase

  • Odwołanie
Moduł:
Azure

Pobiera co najmniej jedną bazę danych.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Get-AzureSqlDatabase pobiera co najmniej jedno wystąpienie usługi Azure SQL Database z serwera usługi Azure SQL Database. Serwer można określić przy użyciu kontekstu połączenia serwera usługi Azure SQL Database utworzonego za pomocą polecenia cmdlet New-AzureSqlDatabaseServerContext . Lub, jeśli określisz nazwę serwera usługi Azure SQL Database, polecenie cmdlet używa bieżących informacji o subskrypcji platformy Azure do uwierzytelniania żądania dostępu do serwera.

Jeśli nie określisz bazy danych, polecenie cmdlet Get-AzureSqlDatabase zwraca wszystkie bazy danych z określonego serwera.

Pobieranie przywracalnych porzuconych baz danych:

Pobierz przywracalne usunięte bazy danych przy użyciu parametru RestoreableDropped . Aby zwrócić wszystkie usunięte bazy danych z możliwością przywracania, użyj parametru RestoreableDropped bez parametru DatabaseName i DatabaseDeletionDate. Aby zwrócić określoną porzuconą bazę danych z możliwością przywracania, użyj parametru RestorableDropped z parametrami DatabaseName i DatabaseDeletionDate . Podczas pobierania określonej usuniętej bazy danych z możliwością przywracania przy użyciu parametru DatabaseName należy również uwzględnić parametr DatabaseDeletionDate , a określona wartość DatabaseDeletionDate musi zawierać milisekundy, aby dopasować je do żądanej bazy danych.

Polecenie cmdlet Get-AzureSqlDatabase zwraca wszystkie przywracalne porzucone bazy danych na serwerze lub jedną konkretną bazę danych zgodną z parametrami DatabaseName i DatabaseDeletionDate. Aby zwrócić usunięte bazy danych, które spełniają różne kryteria, takie jak wszystkie przywracalne usunięte bazy danych o określonej nazwie, należy zwrócić wszystkie przywracalne usunięte bazy danych, a następnie przefiltrować wyniki na kliencie.

Przykłady

Przykład 1. Pobieranie wszystkich baz danych na serwerze

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

To polecenie pobiera wszystkie bazy danych na serwerze o nazwie lpqd0zbr8y.

Przykład 2: Pobieranie wszystkich przywracalnych porzuconych baz danych na serwerze

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

To polecenie pobiera wszystkie przywracalne usunięte bazy danych na serwerze o nazwie lpqd0zbr8y.

Przykład 3. Pobieranie bazy danych z serwera określonego przez kontekst połączenia

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

To polecenie pobiera bazę danych o nazwie Database01 z serwera określonego przez kontekst połączenia $Context.

Przykład 4. Przechowywanie obiektu bazy danych w zmiennej

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

To polecenie pobiera bazę danych o nazwie Database01 z serwera o nazwie lpqd0zbr8y. Polecenie przechowuje obiekt bazy danych w zmiennej $Database 01.

Przykład 5. Pobieranie przywracalnej usuniętej bazy danych

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

To polecenie pobiera przywracaną porzuconą bazę danych o nazwie Database01, która została usunięta w dniu 11.9.2012 r. z serwera o nazwie lpqd0zbr8y. To polecenie przechowuje wyniki w zmiennej $DroppedDB.

Przykład 6. Pobieranie wszystkich przywracalnych porzuconych baz danych na serwerze i filtrowanie wyników

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

To polecenie pobiera wszystkie przywracalne usunięte bazy danych na serwerze o nazwie lpqd0zbr8y, a następnie filtruje wyniki tylko do baz danych o nazwie ContactDB.

Parametry

-ConnectionContext

Określa kontekst połączenia serwera, z którego ma być pobierana baza danych.

Typ:IServerDataServiceContext
Aliasy:Context
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Database

Określa obiekt reprezentujący bazę danych pobieraną przez to polecenie cmdlet.

Typ:Database
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DatabaseDeletionDate

Określa datę i godzinę usunięcia. Jeśli określisz parametr RestorableDropped , określ ten parametr, aby pobrać przywracalną porzuconą bazę danych na podstawie daty i godziny usunięcia.

Parametr DatabaseDeletionDate musi zawierać milisekundy, aby był zgodny z czasem żądanej bazy danych. Określenie wartości bez milisekund powoduje, że baza danych nie zostanie znaleziona.

Typ:DateTime
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DatabaseName

Określa nazwę bazy danych, którą pobiera to polecenie cmdlet.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestorableDropped

Wskazuje, że to polecenie cmdlet zwraca obiekty RestorableDroppedDatabase zamiast obiektów bazy danych . Możesz użyć parametru DatabaseDeletionDate , aby wybrać określoną porzuconą bazę danych, którą można przywrócić.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestorableDroppedDatabase

Określa obiekt reprezentujący przywracaną porzuconą bazę danych pobieraną przez to polecenie cmdlet.

Typ:RestorableDroppedDatabase
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServerName

Określa nazwę serwera, który zawiera bazę danych pobieraną przez to polecenie cmdlet. Polecenie cmdlet używa bieżącej subskrypcji platformy Azure do uzyskiwania dostępu do serwera.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

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

Dane wyjściowe

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

To polecenie cmdlet zwraca obiekt Bazy danych , jeśli nie określisz parametru RestorableDropped .

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

To polecenie cmdlet zwraca obiekt RestorableDroppedDatabase , jeśli określisz parametr RestorableDropped .