Get-AzureSqlDatabase
擷取一或多個資料庫。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet,請參閱 Az 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>]
Description
Get-AzureSqlDatabase Cmdlet 會從 Azure SQL Database 伺服器擷取一或多個 Azure SQL Database 實例。 您可以使用 New-AzureSqlDatabaseServerCoNtext Cmdlet 建立的 Azure SQL Database 伺服器連接內容來指定伺服器。 或者,如果您指定 Azure SQL Database 伺服器名稱,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
指定要從中擷取資料庫之伺服器的連接內容。
Type: | IServerDataServiceContext |
Aliases: | Context |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Database
指定 物件,表示這個 Cmdlet 所擷取的資料庫。
Type: | Database |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DatabaseDeletionDate
指定刪除的日期和時間。 如果您指定 RestorableDropped 參數,請指定此參數,根據刪除日期和時間擷取可還原的卸載資料庫。
DatabaseDeletionDate 參數必須包含毫秒,才能符合所需資料庫的時間。 指定不含毫秒的值會導致找不到資料庫。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseName
指定這個 Cmdlet 擷取的資料庫名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設設定檔讀取。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestorableDropped
指出此 Cmdlet 會 傳回 RestorableDroppedDatabase 物件, 而不是 Database 物件。 您可以使用 DatabaseDeletionDate 參數來選取特定的可還原卸載資料庫。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestorableDroppedDatabase
指定 物件,表示這個 Cmdlet 所擷取的可還原卸載資料庫。
Type: | RestorableDroppedDatabase |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServerName
指定包含此 Cmdlet 所擷取之資料庫的伺服器名稱。 Cmdlet 會使用目前的 Azure 訂用帳戶來存取伺服器。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 物件。