Set-AzResourceGroup
Изменяет группу ресурсов.
Синтаксис
SetByResourceGroupName (по умолчанию)
Set-AzResourceGroup
[-Tag] <Hashtable>
-Name <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SetByResourceGroupId
Set-AzResourceGroup
[-Tag] <Hashtable>
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет Set-AzResourceGroup изменяет свойства группы ресурсов. Этот командлет можно использовать для добавления, изменения или удаления тегов Azure, примененных к группе ресурсов. Укажите параметр Name , чтобы определить группу ресурсов и параметр Тега , чтобы изменить теги. Этот командлет нельзя использовать для изменения имени группы ресурсов.
Примеры
Пример 1. Применение тега к группе ресурсов
Set-AzResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}
Эта команда применяет тег Отдела со значением ИТ-отдела к группе ресурсов, которая не имеет существующих тегов.
Пример 2. Добавление тегов в группу ресурсов
$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -Name "ContosoRG").Tags
В этом примере добавлен тег состояния со значением "Утверждено" и тегом FY2016 в группу ресурсов с существующими тегами. Поскольку указанные теги заменяют существующие теги, необходимо включить существующие теги в новую коллекцию тегов или потерять их. Первая команда получает группу ресурсов ContosoRG и использует метод dot для получения значения свойства Tags. Команда сохраняет теги в переменной $Tags. Вторая команда получает теги в переменной $Tags. Третья команда использует оператор назначения += для добавления тегов Status и FY2016 в массив тегов в переменной $Tags. Четвертая команда использует параметр Tagв Set-AzResourceGroup для применения тегов в переменной $Tags к группе ресурсов ContosoRG. Пятая команда получает все теги, примененные к группе ресурсов ContosoRG. В выходных данных показано, что группа ресурсов имеет тег "Отдел" и два новых тега, "Состояние" и "FY2015".
Пример 3. Удаление всех тегов для группы ресурсов
Set-AzResourceGroup -Name "ContosoRG" -Tag @{}
Эта команда указывает параметр Tag с пустым хэш-табличным значением, чтобы удалить все теги из группы ресурсов ContosoRG.
Параметры
-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 |
-Id
Указывает идентификатор группы ресурсов для изменения.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | ResourceGroupId (Идентификатор группы), ResourceId (Идентификатор ресурса) |
Наборы параметров
SetByResourceGroupId
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя группы ресурсов для изменения.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | ИмяГруппыРесурсов |
Наборы параметров
SetByResourceGroupName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Pre
Указывает, что этот командлет рассматривает версии API предварительной версии, когда она автоматически определяет, какую версию следует использовать.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Tag
Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"} — это пара "имя-значение", которую можно создать и применить к ресурсам и группам ресурсов. После назначения тегов ресурсам и группам можно использовать параметр Тега Get-AzResource и Get-AzResourceGroup для поиска ресурсов и групп по имени тега или имени и значению. Теги можно использовать для классификации ресурсов, таких как отдел или центр затрат, или для отслеживания заметок или комментариев о ресурсах.
Чтобы добавить или изменить тег, необходимо заменить коллекцию тегов для группы ресурсов. Чтобы удалить тег, введите хэш-таблицу со всеми тегами, примененными к группе ресурсов, из Get-AzResourceGroup, за исключением тега, который требуется удалить. Чтобы удалить все теги из группы ресурсов, укажите пустую хэш-таблицу: @{}
Свойства параметра
| Тип: | Hashtable |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Метки |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
