Get-AzTag
Возвращает предопределенные теги Azure | Возвращает весь набор тегов в ресурсе или подписке.
Синтаксис
GetPredefinedTagParameterSet
Get-AzTag
[[-Name] <String>]
[-Detailed]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetByResourceIdParameterSet
Get-AzTag
-ResourceId <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
GetPredefinedTagSet: командлет Get-AzTag получает предопределенные теги Azure в подписке. Этот командлет возвращает основные сведения о тегах или подробных сведениях о тегах и их значениях. Все выходные объекты включают свойство Count, представляющее количество ресурсов и групп ресурсов, к которым применены теги и значения. Модуль тегов Azure, который Get-AzTag является частью, которая поможет вам управлять предопределенными тегами Azure. Тег Azure — это пара "имя-значение", которую можно использовать для классификации ресурсов и групп ресурсов Azure, таких как отдел или центр затрат, или отслеживание заметок или комментариев о ресурсах и группах. Вы можете определить и применить теги на одном шаге, но предопределенные теги позволяют устанавливать стандартные, согласованные, прогнозируемые имена и значения тегов в подписке. Чтобы создать предопределенный тег, используйте командлет New-AzTag. Чтобы применить предопределенный тег к группе ресурсов, используйте параметр Тега командлета New-AzTag. Чтобы найти группы ресурсов для определенного имени тега или имени и значения, используйте параметр Tag командлета Get-AzResourceGroup.
GetByResourceIdParameterSet: командлет Get-AzTag с ResourceId получает весь набор тегов в ресурсе или подписке.
Примеры
Пример 1. Получение всех предопределенных тегов
Get-AzTag
Name Count
======== =====
Department 5
FY2015 2
CostCenter 20
Эта команда получает все предопределенные теги в подписке. Свойство Count показывает, сколько раз тег был применен к ресурсам и группам ресурсов в подписке.
Пример 2. Получение тега по имени
Get-AzTag -Name "Department"
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3
Эта команда получает подробные сведения о теге Отдела и его значениях. Свойство Count показывает, сколько раз тег и каждое из его значений было применено к ресурсам и группам ресурсов в подписке.
Пример 3. Получение значений всех тегов
Get-AzTag -Detailed
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3
Name: FY2015
Count: 2
Name: CostCenter
Count: 20
Values:
Name Count
========== =====
0001 5
0002 10
0003 5
Эта команда использует подробный параметр для получения подробных сведений обо всех предопределенных тегах в подписке. Использование подробного параметра эквивалентно использованию параметра Name для каждого тега.
Пример 4. Получение всего набора тегов в подписке
Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
tagKey1 tagValue1
tagKey2 tagValue2
Эта команда получает весь набор тегов в подписке с {subId}.
Пример 5. Получение всего набора тегов в ресурсе
Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
Dept Finance
Status Normal
Эта команда получает весь набор тегов ресурса с помощью {resourceId}.
Параметры
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметра
| Тип: | IAzureContextContainer |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Detailed
Указывает, что эта операция добавляет сведения о значениях тегов в выходные данные.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
GetPredefinedTagParameterSet
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Имя предопределенного тега. По умолчанию Get-AzTag получает основные сведения обо всех предопределенных тегах в подписке. При указании параметра Nameподробный параметр не действует.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
GetPredefinedTagParameterSet
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ResourceId
Идентификатор ресурса для помеченной сущности. Ресурс, группа ресурсов или подписка могут быть помечены.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
GetByResourceIdParameterSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.