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

Get-AzureRole

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

Возвращает список ролей в службе Microsoft Azure.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

Get-AzureRole
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-RoleName] <String>]
   [-InstanceDetails]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Описание

Командлет Get-AzureRole возвращает объект списка со сведениями о ролях в службе Microsoft Azure. Если указать параметр RoleName , Get-AzureRole возвращает сведения только об этой роли. Если указать параметр InstanceDetails , возвращаются дополнительные сведения, относящиеся к экземпляру.

Примеры

Пример 1. Получение списка ролей для службы

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production"

Эта команда возвращает объект со сведениями обо всех рабочих ролях, работающих в службе MySvc01.

Пример 2. Получение сведений о роли, работающей в службе

PS C:\> Get-AzureRole -ServiceName "MySvc1" -Slot "Staging" -RoleName "MyTestVM3"

Эта команда возвращает объект с подробными сведениями о роли MyTestVM3, работающей в промежуточной среде службы MySvc01.

Пример 3. Получение сведений об экземплярах роли, работающей в службе

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -RoleName "MyTestVM02" -InstanceDetails

Эта команда возвращает объект с подробными сведениями об экземплярах роли MyTestVM02, выполняемой в рабочей среде в службе MySvc01.

Пример 4. Получение таблицы экземпляров роли, связанных со службой

PS C:\> Get-AzureRole -ServiceName "MySvc01" -Slot "Production" -InstanceDetails | Format-Table -Auto "InstanceName", "InstanceSize", "InstanceStatus"

Эта команда возвращает таблицу имени экземпляра, размера и состояния всех экземпляров ролей, работающих в рабочей среде в службе MySvc01.

Параметры

-InformationAction

Указывает, как этот командлет реагирует на событие сведений.

Допустимые значения для этого параметра:

  • Продолжить
  • Пропустить
  • Спрашивать
  • SilentlyContinue
  • Остановить
  • Приостановить
Тип:ActionPreference
Aliases:infa
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InformationVariable

Указывает переменную сведений.

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

-InstanceDetails

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

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

-Profile

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

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

-RoleName

Указывает имя роли для получения.

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

-ServiceName

Указывает имя службы Azure.

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

-Slot

Указывает среду развертывания Azure. Допустимые значения для этого параметра: Рабочая или промежуточная.

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