다음을 통해 공유

Get-AzureSqlDatabase

  • 참조
모듈:
Azure

하나 이상의 데이터베이스를 검색합니다.

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 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 Database 서버에서 하나 이상의 Azure SQL Database 인스턴스를 검색합니다. New-AzureSqlDatabaseServerContext cmdlet을 사용하여 만든 Azure SQL Database 서버 연결 컨텍스트를 사용하여 서버를 지정할 수 있습니다. 또는 Azure SQL Database 서버 이름을 지정하는 경우 cmdlet은 현재 Azure 구독 정보를 사용하여 서버에 액세스하기 위한 요청을 인증합니다.

데이터베이스 를 지정하지 않으면 Get-AzureSqlDatabase cmdlet은 지정된 서버의 모든 데이터베이스를 반환합니다.

복원 가능한 삭제된 데이터베이스 검색:

RestorableDropped 매개 변수를 사용하여 복원 가능한 삭제된 데이터베이스를 검색합니다. 복원 가능한 삭제된 데이터베이스를 모두 반환하려면 DatabaseName 및 DatabaseDeletionDate 없이 RestorableDropped 매개 변수를 사용합니다. 복원 가능한 삭제된 특정 데이터베이스를 반환하려면 DatabaseName 및 DatabaseDeletionDate 매개 변수와 함께 RestorableDropped 매개 변수를 사용합니다. 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"

이 명령은 연결 컨텍스트 $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

이 명령은 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
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Database

이 cmdlet이 검색하는 데이터베이스를 나타내는 개체를 지정합니다.

형식:Database
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DatabaseDeletionDate

삭제 날짜 및 시간을 지정합니다. RestorableDropped 매개 변수를 지정하는 경우 이 매개 변수를 지정하여 삭제 날짜 및 시간을 기준으로 복원 가능한 삭제된 데이터베이스를 검색합니다.

DatabaseDeletionDate 매개 변수는 원하는 데이터베이스의 시간과 일치하도록 밀리초를 포함해야 합니다. 밀리초 없이 값을 지정하면 데이터베이스를 찾을 수 없습니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DatabaseName

이 cmdlet이 검색하는 데이터베이스의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

형식:AzureSMProfile
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RestorableDropped

이 cmdlet은 Database 개체 대신 RestorableDroppedDatabase 개체를 반환합니다. DatabaseDeletionDate 매개 변수를 사용하여 복원 가능한 특정 삭제된 데이터베이스를 선택할 수 있습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RestorableDroppedDatabase

이 cmdlet이 검색하는 복원 가능한 삭제된 데이터베이스를 나타내는 개체를 지정합니다.

형식:RestorableDroppedDatabase
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ServerName

이 cmdlet에서 검색하는 데이터베이스를 포함하는 서버의 이름을 지정합니다. cmdlet은 현재 Azure 구독을 사용하여 서버에 액세스합니다.

형식:String
Position:Named
Default value: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\>

이 cmdlet은 RestorableDropped 매개 변수를 지정하지 않으면 Database 개체를 반환합니다.

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

이 cmdlet은 RestorableDropped 매개 변수를 지정하는 경우 RestorableDroppedDatabase 개체를 반환합니다.