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


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.

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

String

SwitchParameter

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

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