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

Get-AzResourceGroup

Модуль:
Az.Resources Module

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

Синтаксис

GetByResourceGroupName (по умолчанию) 

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

GetByResourceGroupId 

Get-AzResourceGroup
    [[-Location] <String>]
    [-Id <String>]
    [-ExpandProperties]
    [-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*

Пример 7. Получение группы ресурсов с расширенными свойствами

Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties

Параметры

-ApiVersion

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

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

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExpandProperties

При указании выходные данные включают CreatedTime и ChangedTime ресурса.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Id

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ResourceGroupId (Идентификатор группы), ResourceId (Идентификатор ресурса)

Наборы параметров

GetByResourceGroupId
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Location

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False
Aliases:ИмяГруппыРесурсов

Наборы параметров

GetByResourceGroupName
Position:0
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Pre

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Tag

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

Свойства параметра

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

GetByResourceGroupName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

Hashtable

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

PSResourceGroup