Get-AzureSqlDatabase

モジュール:

Azure

1 つ以上のデータベースを取得します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「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>]

説明

Get-AzureSqlDatabase コマンドレットは、Azure SQL Database サーバーから Azure SQL Database の 1 つ以上のインスタンスを取得します。 New-AzureSqlDatabaseServerContext コマンドレットを使用して作成する Azure SQL Database サーバー接続コンテキストを持つサーバーを指定できます。 または、Azure SQL Database サーバー名を指定した場合、コマンドレットは現在の Azure サブスクリプション情報を使用して、サーバーへのアクセス要求を認証します。

データベースを指定しない場合、 Get-AzureSqlDatabase コマンドレットは、指定されたサーバーからすべてのデータベースを返します。

復元可能な削除されたデータベースの取得:

RestorableDropped パラメーターを使用して、 復元可能な削除されたデータベースを 取得します。 削除されたすべての復元可能なデータベースを返すには、DatabaseName と DatabaseDeletionDate を指定せずに RestorableDropped パラメーターを使用します。 特定の復元可能な削除されたデータベースを返すには、DatabaseName パラメーターと DatabaseDeletionDate パラメーターを指定して RestorableDropped パラメーターを使用します。 DatabaseName パラメーターを使用して特定の復元可能な削除されたデータベースを取得する場合は、DatabaseDeletionDate パラメーターも含める必要があります。また、指定した DatabaseDeletionDate 値には、目的のデータベースと一致するミリ秒を含める必要があります。

Get-AzureSqlDatabase コマンドレットは、サーバー上のすべての復元可能な削除されたデータベース、または DatabaseName と DatabaseDeletionDate の両方に一致する 1 つの特定のデータベースを返します。 特定の名前の復元可能な削除されたデータベースなど、異なる条件を満たす復元可能な削除されたデータベースを返すには、復元可能なすべての削除されたデータベースを返し、クライアントで結果をフィルター処理する必要があります。

例

例 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"

このコマンドは、接続コンテキスト $Contextで指定されたサーバーから Database01 という名前のデータベースを取得します。

例 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

このコマンドは、2012 年 11 月 9 日に削除された Database01 という名前の復元可能な削除されたデータベースを lpqd0zbr8y という名前のサーバーから取得します。 このコマンドは、結果を $DroppedDB 変数に格納します。

例 6: サーバー上の復元可能なすべての削除されたデータベースを取得し、結果をフィルター処理する

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

このコマンドは、lpqd0zbr8y という名前のサーバー上の復元可能な削除されたデータベースをすべて取得し、ContactDB という名前のデータベースのみに結果をフィルター処理します。

パラメーター

-ConnectionContext

データベースを取得するサーバーの接続コンテキストを指定します。

型:	IServerDataServiceContext
Aliases:	Context
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Database

このコマンドレットが取得するデータベースを表すオブジェクトを指定します。

型:	Database
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DatabaseDeletionDate

削除の日時を指定します。 RestorableDropped パラメーターを 指定する場合は、削除日時に基づいて復元可能な削除された データベースを取得するには、このパラメーターを指定します。

DatabaseDeletionDate パラメーターには、目的のデータベースの時刻と一致するミリ秒を含める必要があります。 ミリ秒単位で値を指定すると、データベースが見つかりません。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatabaseName

このコマンドレットが取得するデータベースの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:	AzureSMProfile
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RestorableDropped

このコマンドレットは、データベース オブジェクトではなく RestorableDroppedDatabase オブジェクトを返します。 DatabaseDeletionDate パラメーターを使用して、復元可能な削除された特定のデータベースを選択できます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RestorableDroppedDatabase

このコマンドレットが取得する復元可能な削除されたデータベースを表すオブジェクトを指定します。

型:	RestorableDroppedDatabase
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ServerName

このコマンドレットが取得するデータベースを含むサーバーの名前を指定します。 このコマンドレットは、現在の Azure サブスクリプションを使用してサーバーにアクセスします。

型:	String
配置:	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 パラメーターを指定しない場合、このコマンドレットは Database オブジェクトを返します。

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

このコマンドレットは、RestorableDropped パラメーターを指定した場合に RestorableDroppedDatabase オブジェクトを返します。

関連リンク

• Azure SQL データベース
• Azure SQL データベースの操作
• New-AzureSqlDatabase
• New-AzureSqlDatabaseServerContext
• Remove-AzureSqlDatabase
• Set-AzureSqlDatabase