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

Get-AzResourceGroup

  • Ссылка
Модуль:
Az.Resources

Возвращает группы ресурсов.

Синтаксис

Get-AzResourceGroup
   [[-Name] <String>]
   [[-Location] <String>]
   [-Tag <Hashtable>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzResourceGroup
   [[-Location] <String>]
   [-Id <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет Get-AzResourceGroup получает группы ресурсов Azure в текущей подписке. Вы можете получить все группы ресурсов или указать группу ресурсов по имени или другим свойствам. По умолчанию этот командлет получает все группы ресурсов в текущей подписке. Дополнительные сведения о ресурсах Azure и группах ресурсов Azure см. в командлете New-AzResourceGroup.

Примеры

Пример 1. Получение группы ресурсов по имени

Get-AzResourceGroup -Name "EngineerBlog"

Эта команда получает группу ресурсов Azure в подписке с именем EngineerBlog.

Пример 2. Получение всех тегов группы ресурсов

(Get-AzResourceGroup -Name "ContosoRG").Tags

Эта команда получает группу ресурсов с именем ContosoRG и отображает теги, связанные с этой группой.

Пример 3. Получение групп ресурсов на основе тега

Get-AzResourceGroup -Tag @{'environment'='prod'}

Пример 4. Отображение групп ресурсов по расположению

Get-AzResourceGroup |
  Sort-Object Location,ResourceGroupName |
    Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

Пример 5. Отображение имен всех групп ресурсов в определенном расположении

Get-AzResourceGroup -Location westus2 |
  Sort-Object ResourceGroupName |
    Format-Wide ResourceGroupName -Column 4

Пример 6. Отображение групп ресурсов, имена которых начинаются с webServer

Get-AzResourceGroup -Name WebServer*

Параметры

-ApiVersion

Указывает версию API, поддерживаемую поставщиком ресурсов. Можно указать другую версию, отличную от версии по умолчанию.

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

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

-Id

Указывает идентификатор группы ресурсов для получения. Подстановочные знаки не допускаются.

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

-Location

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

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

-Name

Указывает имя группы ресурсов для получения. Этот параметр поддерживает подстановочные знаки в начале и /или конце строки.

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

-Pre

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

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

-Tag

Хэш-файл тега для фильтрации групп ресурсов.

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

Входные данные

String

Hashtable

Выходные данные

PSResourceGroup