Поделиться через

Get-AzureSqlDatabase

  • Ссылка
Модуль:
Azure

Извлекает одну или несколько баз данных.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль 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>]

Описание

Командлет Get-AzureSqlDatabase извлекает один или несколько экземпляров База данных SQL Azure с сервера База данных SQL Azure. Сервер можно указать с помощью контекста подключения к серверу База данных SQL Azure, создаваемого с помощью командлета New-AzureSqlDatabaseServerContext. Или, если указать имя сервера База данных SQL Azure, командлет использует текущие сведения о подписке Azure для проверки подлинности запроса на доступ к серверу.

Если база данных не указана, командлет Get-AzureSqlDatabase возвращает все базы данных с указанного сервера.

Получение восстанавливаемых удаленных баз данных:

Извлеките восстанавливаемые базы данных с помощью параметра RestorableDropped . Чтобы вернуть все восстанавливаемые базы данных, используйте параметр RestorableDropped без DatabaseName и DatabaseDeletionDate. Чтобы вернуть определенную удаленную базу данных, используйте параметр RestorableDropped с параметрами DatabaseName и DatabaseDeletionDate . При получении определенной восстанавливаемой базы данных с помощью параметра DatabaseName необходимо также включить параметр DatabaseDeletionDate, а указанное значение DatabaseDeletionDeletionDate должно включать миллисекунды для сопоставления требуемой базы данных.

Командлет Get-AzureSqlDatabase возвращает все восстанавливаемые базы данных на сервере или одну конкретную базу данных, которая соответствует как DatabaseName, так и DatabaseDeletionDeletionDate. Чтобы вернуть восстанавливаемые базы данных, удовлетворяющие разным критериям, таким как все восстанавливаемые базы данных определенного имени, необходимо вернуть все восстанавливаемые базы данных, а затем отфильтровать результаты на клиенте.

Примеры

Пример 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"

Эта команда извлекает базу данных с именем Database01 с сервера с именем lpqd0zbr8y. Команда сохраняет объект базы данных в переменной $Database 01.

Пример 5. Получение восстанавливаемой базы данных

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

Эта команда извлекает восстанавливаемую удаленную базу данных с именем Database01, которая была удалена 11.9.2012 с сервера с именем lpqd0zbr8y. Эта команда сохраняет результаты в переменной $DroppedDB.

Пример 6. Получение всех восстанавливаемых баз данных на сервере и фильтрация результатов

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

Эта команда извлекает все восстанавливаемые базы данных на сервере с именем lpqd0zbr8y, а затем фильтрует результаты только для баз данных с именем ContactDB.

Параметры

-ConnectionContext

Указывает контекст подключения сервера, из которого требуется получить базу данных.

Тип:IServerDataServiceContext
Aliases:Context
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Database

Указывает объект, представляющий базу данных, извлекаемую этим командлетом.

Тип:Database
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DatabaseDeletionDate

Указывает дату и время удаления. Если указать параметр RestorableDropped , укажите этот параметр, чтобы получить восстанавливаемую удаленную базу данных на основе даты и времени удаления.

Параметр DatabaseDeletionDate должен содержать миллисекунда, чтобы соответствовать времени требуемой базы данных. Указание значения без миллисекунда приводит к тому, что база данных не найдена.

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DatabaseName

Указывает имя базы данных, извлекаемой этим командлетом.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Тип:AzureSMProfile
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RestorableDropped

Указывает, что этот командлет возвращает объекты RestorableDroppedDatabase вместо объектов Database . Параметр DatabaseDeletionDate можно использовать для выбора определенной восстанавливаемой базы данных.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RestorableDroppedDatabase

Указывает объект, представляющий восстанавливаемую удаленную базу данных, извлекаемую этим командлетом.

Тип:RestorableDroppedDatabase
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ServerName

Указывает имя сервера, содержащего базу данных, извлекаемую этим командлетом. Командлет использует текущую подписку 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\>

Этот командлет возвращает объект Database, если параметр RestorableDropped не указан.

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

Этот командлет возвращает объект RestorableDroppedDatabase , если указать параметр RestorableDropped .