Get-AzureSqlDatabase
擷取一或多個資料庫。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。
語法
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
Get-AzureSqlDatabase Cmdlet 會從 Azure SQL 資料庫 伺服器擷取一或多個 Azure SQL 資料庫 實例。 您可以使用 New-AzureSqlDatabaseServerContext Cmdlet 建立的 Azure SQL 資料庫 伺服器連線內容來指定伺服器。 或者，如果您指定 Azure SQL 資料庫 伺服器名稱，Cmdlet 會使用目前的 Azure 訂用帳戶資訊來驗證存取伺服器的要求。
如果您未指定資料庫， Get-AzureSqlDatabase Cmdlet 會從指定的伺服器傳回所有資料庫。
擷取可還原的已卸除資料庫：
使用 RestorableDropped 參數擷取可還原的已卸除資料庫。 若要傳回所有可還原的已卸除資料庫，請使用沒有 DatabaseName 和 DatabaseDeletionDate 的 RestorableDropped 參數。 若要傳回特定的可還原卸除資料庫， 請使用 RestorableDropped 參數搭配 DatabaseName 和 DatabaseDeletionDate 參數。 使用 DatabaseName 參數擷取特定的可還原卸除資料庫時，您也必須包含 DatabaseDeletionDate 參數，而指定的 DatabaseDeletionDate 值必須包含毫秒才能符合所需的資料庫。
Get-AzureSqlDatabase Cmdlet 會傳回伺服器上所有可還原的已卸除資料庫，或一個符合 DatabaseName 和 DatabaseDeletionDate 的特定資料庫。 若要傳回符合不同準則的可還原卸除資料庫，例如特定名稱的所有可還原卸除資料庫，您必須傳回所有可還原的卸除資料庫，然後在客戶端上篩選結果。
範例
範例 1：擷取伺服器上的所有資料庫
PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y"此命令會擷取伺服器上名為 lpqd0zbr8y 的所有資料庫。
範例 2：擷取伺服器上所有可還原的已卸除資料庫
PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -RestorableDropped此命令會擷取伺服器上名為 lpqd0zbr8y 的所有可還原卸除資料庫。
範例 3：從連接內容指定的伺服器擷取資料庫
PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"此命令會從連接內容所指定的伺服器擷取名為 Database01 的資料庫$Context。
範例 4：將資料庫物件儲存在變數中
PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"此命令會從名為 lpqd0zbr8y 的伺服器擷取名為 Database01 的資料庫。 命令會將資料庫物件儲存在 $Database 01 變數中。
範例 5：擷取可還原的已卸除資料庫
PS C:\> $DroppedDB = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -DatabaseDeletionDate "2012-11-09T22:59:43.000Z" -RestorableDropped此命令會從名為 lpqd0zbr8y 的伺服器擷取在 2012/11/9 刪除的可還原卸除資料庫 Database01。 此命令會將結果儲存在 $DroppedDB 變數中。
範例 6：擷取伺服器上所有可還原的已卸除資料庫，並篩選結果
PS C:\> Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -RestorableDropped | Where-Object {$_.Name -eq "ContactDB"}此命令會擷取伺服器上名為 lpqd0zbr8y 的所有可還原卸除資料庫，然後將結果篩選為只有名為 ContactDB 的資料庫。
參數
-ConnectionContext
指定要從中擷取資料庫之伺服器的連接內容。
| 類型: | IServerDataServiceContext |
| 別名: | Context |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Database
指定物件，表示這個 Cmdlet 所擷取的資料庫。
| 類型: | Database |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DatabaseDeletionDate
指定刪除的日期和時間。 如果您指定 RestorableDropped 參數，請指定此參數，根據刪除日期和時間擷取可還原的卸除資料庫。
DatabaseDeletionDate 參數必須包含毫秒，才能符合所需資料庫的時間。 指定不含毫秒的值會導致找不到資料庫。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DatabaseName
指定這個 Cmdlet 擷取的資料庫名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。
| 類型: | AzureSMProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RestorableDropped
指出此 Cmdlet 會 傳回 RestorableDroppedDatabase 物件， 而不是 Database 物件。 您可以使用 DatabaseDeletionDate 參數來選取特定的可還原卸除資料庫。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RestorableDroppedDatabase
指定物件，表示這個 Cmdlet 所擷取的可還原卸除資料庫。
| 類型: | RestorableDroppedDatabase |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ServerName
指定包含此 Cmdlet 所擷取之資料庫的伺服器名稱。 Cmdlet 會使用目前的 Azure 訂用帳戶來存取伺服器。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸入
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestorableDroppedDatabase
輸出
IEnumerable\<Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database\>
如果您未指定 RestorableDropped 參數，此 Cmdlet 會傳回 Database 物件。
IEnumerable\<Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.RestorableDroppedDatabase\>
如果您指定 RestorableDropped 參數，此 Cmdlet 會傳回 RestorableDroppedDatabase 物件。