Sdílet prostřednictvím

Get-AzureSqlDatabase

  • Reference
Modul:
Azure

Načte jednu nebo více databází.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

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

Rutina Get-AzureSqlDatabase načte jednu nebo více instancí služby Azure SQL Database ze serveru Azure SQL Database. Pomocí rutiny New-AzureSqlDatabaseServerContext můžete zadat server s kontextem připojení k serveru Azure SQL Database. Nebo pokud zadáte název serveru azure SQL Database, rutina použije aktuální informace o předplatném Azure k ověření žádosti o přístup k serveru.

Pokud nezadáte databázi, vrátí rutina Get-AzureSqlDatabase všechny databáze ze zadaného serveru.

Načítání obnovovatelných vyřazených databází:

Pomocí parametru RestorableDropped načtěte obnovené vyřazené databáze. Pokud chcete vrátit všechny obnovené vyřazené databáze, použijte parametr RestorableDropped bez DatabaseName a DatabaseDeletionDate. Pokud chcete vrátit konkrétní obnovenou vyřazenou databázi, použijte parametr RestorableDropped s parametry DatabaseName a DatabaseDeletionDate . Při načítání konkrétní obnovené vyřazené databáze pomocí parametru DatabaseName musíte zahrnout také Parametr DatabaseDeletionDate a zadaná hodnota DatabaseDeletionDate musí obsahovat milisekundy odpovídající požadované databázi.

Rutina Get-AzureSqlDatabase vrátí buď všechny obnovené vyřazené databáze na serveru, nebo jednu konkrétní databázi, která odpovídá DatabaseName i DatabaseDeletionDate. Chcete-li vrátit obnovitelné vyřazené databáze, které splňují různá kritéria, například všechny obnovené vyřazené databáze určitého názvu, musíte vrátit všechny obnovené vyřazené databáze a potom filtrovat výsledky v klientovi.

Příklady

Příklad 1: Načtení všech databází na serveru

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

Tento příkaz načte všechny databáze na serveru s názvem lpqd0zbr8y.

Příklad 2: Načtení všech obnovených vyřazených databází na serveru

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

Tento příkaz načte všechny obnovené vyřazené databáze na serveru s názvem lpqd0zbr8y.

Příklad 3: Načtení databáze ze serveru určeného kontextem připojení

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

Tento příkaz načte databázi s názvem Database01 ze serveru určeného kontextem připojení $Context.

Příklad 4: Uložení databázového objektu do proměnné

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

Tento příkaz načte databázi s názvem Database01 ze serveru s názvem lpqd0zbr8y. Příkaz uloží databázový objekt do proměnné $Database 01.

Příklad 5: Načtení obnovené vyřazené databáze

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

Tento příkaz načte obnovenou vyřazenou databázi s názvem Database01, která byla odstraněna 9. 11. 2012 ze serveru s názvem lpqd0zbr8y. Tento příkaz uloží výsledky do proměnné $DroppedDB.

Příklad 6: Načtení všech obnovených vyřazených databází na serveru a filtrování výsledků

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

Tento příkaz načte všechny obnovené vyřazené databáze na serveru s názvem lpqd0zbr8y a potom vyfiltruje výsledky pouze na databáze s názvem ContactDB.

Parametry

-ConnectionContext

Určuje kontext připojení serveru, ze kterého se má načíst databáze.

Typ:IServerDataServiceContext
Aliases:Context
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-Database

Určuje objekt, který představuje databázi, kterou tato rutina načte.

Typ:Database
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseDeletionDate

Určuje datum a čas odstranění. Pokud zadáte parametr RestorableDropped , zadejte tento parametr, který načte obnovitelnou vyřazenou databázi na základě data a času odstranění.

Parametr DatabaseDeletionDate musí obsahovat milisekundy, aby odpovídal době požadované databáze. Zadání hodnoty bez milisekund vede k tomu, že databáze nebyla nalezena.

Typ:DateTime
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Určuje název databáze, kterou tato rutina načte.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-RestorableDropped

Označuje, že tato rutina vrací objekty RestorableDroppedDatabase místo databázových objektů. Pomocí parametru DatabaseDeletionDate můžete vybrat konkrétní obnovenou vyřazenou databázi.

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-RestorableDroppedDatabase

Určuje objekt, který představuje obnovitelnou vyřazenou databázi, kterou tato rutina načte.

Typ:RestorableDroppedDatabase
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

Určuje název serveru, který obsahuje databázi, kterou tato rutina načte. Rutina používá k přístupu k serveru aktuální předplatné Azure.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

Vstupy

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

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

Výstupy

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

Tato rutina vrátí databázový objekt, pokud nezadáte parametr RestorableDropped.

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

Tato rutina vrátí objekt RestorableDroppedDatabase , pokud zadáte parametr RestorableDropped .