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

Set-AzureRmResourceGroup

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

Изменяет группу ресурсов.

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

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

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

Синтаксис

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

Описание

Командлет Set-AzureRmResourceGroup изменяет свойства группы ресурсов. Этот командлет можно использовать для добавления, изменения или удаления тегов Azure, примененных к группе ресурсов. Укажите параметр Name, чтобы определить группу ресурсов и параметр Тега, чтобы изменить теги. Этот командлет нельзя использовать для изменения имени группы ресурсов.

Примеры

Пример 1. Применение тега к группе ресурсов

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}

Эта команда применяет тег Отдела со значением ИТ-отдела к группе ресурсов, которая не имеет существующих тегов.

Пример 2. Добавление тегов в группу ресурсов

PS C:\>$Tags = (Get-AzureRmResourceGroup -Name "ContosoRG").Tags
PS C:\> $Tags
PS C:\> $Tags += @{"Status"="Approved"; "FY2016"=$null}
PS C:\> Set-AzureRmResourceGroup -Name "ContosoRG" -Tag $Tags
PS C:> (Get-AzureRmResourceGroup -Name "ContosoRG").Tags

В этом примере добавлен тег состояния со значением "Утверждено" и тегом FY2016 в группу ресурсов с существующими тегами. Поскольку указанные теги заменяют существующие теги, необходимо включить существующие теги в новую коллекцию тегов или потерять их. Первая команда получает группу ресурсов ContosoRG и использует метод dot для получения значения свойства Tags. Команда сохраняет теги в переменной $Tags. Вторая команда получает теги в переменной $Tags. Третья команда использует оператор назначения += для добавления тегов Status и FY2016 в массив тегов в переменной $Tags. Четвертая команда использует параметр Тега Set-AzureRmResourceGroup для применения тегов в переменной $Tags к группе ресурсов ContosoRG. Пятая команда получает все теги, примененные к группе ресурсов ContosoRG. В выходных данных показано, что группа ресурсов имеет тег "Отдел" и два новых тега, "Состояние" и "FY2015".

Пример 3. Удаление всех тегов для группы ресурсов

PS C:\>Set-AzureRmResourceGroup -Name "ContosoRG" -Tag @{}

Эта команда указывает параметр Tag с пустым хэш-табличным значением, чтобы удалить все теги из группы ресурсов ContosoRG.

Параметры

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

-Name

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

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

-Pre

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

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

-Tag

Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"} — это пара "имя-значение", которую можно создать и применить к ресурсам и группам ресурсов. После назначения тегов ресурсам и группам можно использовать параметр Тега Get-AzureRmResource и Get-AzureRmResourceGroup для поиска ресурсов и групп по имени тега или имени и значению. Теги можно использовать для классификации ресурсов, таких как отдел или центр затрат, или для отслеживания заметок или комментариев о ресурсах. Чтобы добавить или изменить тег, необходимо заменить коллекцию тегов для группы ресурсов. Чтобы удалить тег, введите хэш-таблицу со всеми тегами, которые сейчас применяются к группе ресурсов, из Get-AzureRmResourceGroup, за исключением тега, который требуется удалить. Чтобы удалить все теги из группы ресурсов, укажите пустую хэш-таблицу: @{}

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

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

None

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

Microsoft.Azure.Commands.Resources.Models.PSResourceGroup