다음을 통해 공유


Get-AzTag

미리 정의된 Azure 태그를 가져옵니다. | 리소스 또는 구독의 전체 태그 집합을 가져옵니다.

구문

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

Description

GetPredefinedTagSet: Get-AzTag cmdlet은 구독에서 미리 정의된 Azure 태그를 가져옵니다. 이 cmdlet은 태그에 대한 기본 정보 또는 태그 및 해당 값에 대한 자세한 정보를 반환합니다. 모든 출력 개체에는 태그와 값이 적용된 리소스 및 리소스 그룹의 수를 나타내는 Count 속성이 포함됩니다. Get-AzTag포함된 Azure 태그 모듈은 미리 정의된 Azure 태그를 관리하는 데 도움이 될 수 있습니다. Azure 태그는 부서 또는 비용 센터와 같은 Azure 리소스 및 리소스 그룹을 분류하거나 리소스 및 그룹에 대한 메모 또는 의견을 추적하는 데 사용할 수 있는 이름-값 쌍입니다. 한 단계에서 태그를 정의하고 적용할 수 있지만 미리 정의된 태그를 사용하면 구독의 태그에 대한 표준적이고 일관되고 예측 가능한 이름과 값을 설정할 수 있습니다. 미리 정의된 태그를 만들려면 New-AzTag cmdlet을 사용합니다. 리소스 그룹에 미리 정의된 태그를 적용하려면 New-AzTag cmdlet의 Tag 매개 변수를 사용합니다. 리소스 그룹에서 특정 태그 이름 또는 이름 및 값을 검색하려면 Get-AzResourceGroup cmdlet의 Tag 매개 변수를 사용합니다.

GetByResourceIdParameterSet: ResourceId가 있는 Get-AzTag cmdlet은 리소스 또는 구독에서 전체 태그 집합을 가져옵니다.

예제

예제 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

이 명령은 Detailed 매개 변수를 사용하여 구독의 모든 미리 정의된 태그에 대한 자세한 정보를 가져옵니다. Detailed 매개 변수를 사용하는 것은 모든 태그에 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
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Detailed

이 작업은 출력에 태그 값에 대한 정보를 추가한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

미리 정의된 태그의 이름입니다. 기본적으로 Get-AzTag 는 구독의 모든 미리 정의된 태그에 대한 기본 정보를 가져옵니다. Name 매개 변수지정하면 Detailed 매개 변수가 적용되지 않습니다.

형식:String
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceId

태그가 지정된 엔터티의 리소스 식별자입니다. 리소스, 리소스 그룹 또는 구독에 태그가 지정될 수 있습니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

SwitchParameter

출력

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