Get-AzTag

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

Возвращает предопределенные теги Azure | Возвращает весь набор тегов в ресурсе или подписке.

Синтаксис

Get-AzTag
   [[-Name] <String>]
   [-Detailed]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzTag
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

GetPredefinedTagSet: командлет Get-AzTag получает предопределенные теги Azure в подписке. Этот командлет возвращает основные сведения о тегах или подробных сведениях о тегах и их значениях. Все выходные объекты включают свойство Count, представляющее количество ресурсов и групп ресурсов, к которым применены теги и значения. Модуль тегов Azure, который Get-AzTag является частью, которая поможет вам управлять предопределенными тегами Azure. Тег Azure — это пара "имя-значение", которую можно использовать для классификации ресурсов и групп ресурсов Azure, таких как отдел или центр затрат, или отслеживание заметок или комментариев о ресурсах и группах. Вы можете определить и применить теги на одном шаге, но предопределенные теги позволяют устанавливать стандартные, согласованные, прогнозируемые имена и значения тегов в подписке. Чтобы создать предопределенный тег, используйте командлет New-AzTag. Чтобы применить предопределенный тег к группе ресурсов, используйте параметр Tag командлета 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.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

Указывает, что эта операция добавляет сведения о значениях тегов в выходные данные.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Имя предопределенного тега. По умолчанию Get-AzTag получает основные сведения обо всех предопределенных тегах в подписке. При указании параметра Name подробный параметр не действует.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Идентификатор ресурса для помеченной сущности. Ресурс, группа ресурсов или подписка могут быть помечены.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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

String

SwitchParameter

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

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource