Get-AzureRmTag
Возвращает предопределенные теги Azure.
Предупреждение
Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.
Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.
Синтаксис
Get-AzureRmTag
[[-Name] <String>]
[-Detailed]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет Get-AzureRmTag получает предопределенные теги Azure в подписке. Этот командлет возвращает основные сведения о тегах или подробных сведениях о тегах и их значениях. Все выходные объекты включают свойство Count, представляющее количество ресурсов и групп ресурсов, к которым применены теги и значения. Модуль тегов Azure, который Get-AzureRMTag является частью, которая поможет вам управлять предопределенными тегами Azure. Тег Azure — это пара "имя-значение", которую можно использовать для классификации ресурсов и групп ресурсов Azure, таких как отдел или центр затрат, или отслеживание заметок или комментариев о ресурсах и группах. Вы можете определить и применить теги на одном шаге, но предопределенные теги позволяют устанавливать стандартные, согласованные, прогнозируемые имена и значения тегов в подписке. Чтобы создать предопределенный тег, используйте командлет New-AzureRmTag. Чтобы применить предопределенный тег к группе ресурсов, используйте параметр Тега командлета New-AzureRmTag. Чтобы найти группы ресурсов для определенного имени тега или имени и значения, используйте параметр Тега командлета Get-AzureRMResourceGroup.
Примеры
Пример 1. Получение всех предопределенных тегов
PS C:\>Get-AzureRmTag
Name Count
======== =====
Department 5
FY2015 2
CostCenter 20
Эта команда получает все предопределенные теги в подписке. Свойство Count показывает, сколько раз тег был применен к ресурсам и группам ресурсов в подписке.
Пример 2. Получение тега по имени
PS C:\>Get-AzureRmTag -Name "Department"
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3
Эта команда получает подробные сведения о теге Отдела и его значениях. Свойство Count показывает, сколько раз тег и каждое из его значений было применено к ресурсам и группам ресурсов в подписке.
Пример 3. Получение значений всех тегов
PS C:\>Get-AzureRmTag -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 для каждого тега.
Параметры
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Detailed
Указывает, что эта операция добавляет сведения о значениях тегов в выходные данные.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Name
Указывает имя тега для получения. По умолчанию Get-AzureRmTag получает основные сведения обо всех предопределенных тегах в подписке. При указании параметра Name подробный параметр не действует.
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |