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


Get-AzureRmResourceGroup

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

Предупреждение

Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

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

Описание

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

Примеры

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

PS C:\>Get-AzureRmResourceGroup -Name "EngineerBlog"

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

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

PS C:\>(Get-AzureRmResourceGroup -Name "ContosoRG").Tags

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

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

PS C:\> Get-AzureRmResourceGroup |
  Sort Location,ResourceGroupName |
  Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

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

PS C:\> Get-AzureRmResourceGroup -Location westus2 |
   Sort ResourceGroupName | 
   Format-Wide ResourceGroupName -Column 4

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

PS C:\> Get-AzureRmResourceGroup | Where ResourceGroupName -like WebServer*

Параметры

-ApiVersion

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

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

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases: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:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

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

-Pre

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

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

-Tag

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

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

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

None

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

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup