다음을 통해 공유

New-AzTag

  • 참조
모듈:
Az.Resources

미리 정의된 Azure 태그를 만들거나 기존 태그에 값을 추가합니다. | 리소스 또는 구독에서 전체 태그 집합을 만들거나 업데이트합니다.

구문

New-AzTag
   [-Name] <String>
   [[-Value] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzTag
   [-ResourceId] <String>
   [-Tag] <Hashtable>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

CreatePredefinedTagSet: New-AzTag cmdlet은 선택적 미리 정의된 값으로 미리 정의된 Azure 태그를 만듭니다. 또한 이를 사용하여 기존 미리 정의된 태그에 값을 추가할 수도 있습니다. 미리 정의된 태그를 만들려면 고유한 태그 이름을 입력합니다. 기존 미리 정의된 태그에 값을 추가하려면 기존 태그의 이름과 새 값을 지정합니다. 이 cmdlet은 새 태그나 수정된 태그를 해당 값과 적용된 리소스 수를 나타내는 개체를 반환합니다. New-AzTag Azure Tags 모듈은 미리 정의된 Azure 태그를 관리하는 데 도움이 될 수 있습니다. Azure 태그는 부서 또는 비용 센터와 같은 Azure 리소스 및 리소스 그룹을 분류하거나 리소스 및 그룹에 대한 메모 또는 의견을 추적하는 데 사용할 수 있는 이름-값 쌍입니다. 한 단계에서 태그를 정의하고 적용할 수 있지만 미리 정의된 태그를 사용하면 구독의 태그에 대한 표준적이고 일관되고 예측 가능한 이름과 값을 설정할 수 있습니다. 리소스 또는 리소스 그룹에 미리 정의된 태그를 적용하려면 New-AzTag cmdlet의 Tag 매개 변수를 사용합니다. 지정된 태그 이름 또는 이름 및 값을 가진 리소스 그룹을 검색하려면 Get-AzResourceGroup cmdlet의 Tag 매개 변수를 사용합니다. 모든 태그에는 이름이 있습니다. 값은 선택 사항입니다. 미리 정의된 Azure 태그에는 여러 값이 있을 수 있지만 리소스 또는 리소스 그룹에 태그를 적용하면 태그 이름과 해당 값 중 하나만 적용됩니다. 예를 들어 재무, 인사 및 IT와 같은 각 부서의 값을 사용하여 미리 정의된 부서 태그를 만들 수 있습니다. 리소스에 부서 태그를 적용하는 경우 재무와 같은 미리 정의된 값 하나만 적용합니다.

CreateByResourceIdParameterSet: ResourceId 있는 New-AzTag cmdlet은 리소스 또는 구독에서 전체 태그 집합을 만들거나 업데이트합니다. 이 작업을 통해 지정된 리소스 또는 구독에서 전체 태그 집합을 추가하거나 바꿀 수 있습니다. 지정된 엔터티는 최대 50개의 태그를 가질 수 있습니다.

예제

예제 1: 미리 정의된 태그 만들기

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values 
----   ----------- ----- ------
FY2015             0     {}

이 명령은 FY2015라는 미리 정의된 태그를 만듭니다. 이 태그에는 값이 없습니다. 리소스 또는 리소스 그룹에 값이 없는 태그를 적용하거나 New-AzTag 사용하여 태그에 값을 추가할 수 있습니다. 리소스 또는 리소스 그룹에 태그를 적용할 때 값을 지정할 수도 있습니다.

예제 2: 값을 사용하여 미리 정의된 태그 만들기

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 

        Name        Count
        =========   =====
        Finance     0

이 명령은 Finance 값을 사용하여 Department라는 미리 정의된 태그를 만듭니다.

예제 3: 미리 정의된 태그에 값 추가

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0 
New-AzTag -Name "Department" -Value "IT"
Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0
        IT          0

이러한 명령은 두 값으로 Department라는 미리 정의된 태그를 만듭니다. 태그 이름이 있는 경우 New-AzTag 새 태그를 만드는 대신 기존 태그에 값을 추가합니다.

예제 4: 미리 정의된 태그 사용

New-AzTag -Name "CostCenter" -Value "0001"

Name:   CostCenter
Count:  0
Values: 
        Name        Count
        =========   =====
        0001        0 

Set-AzResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}

Name:      EngineerBlog
Location:  East US
Resources: 
            
  Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US
    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001 

Get-AzTag -Name "CostCenter"

Name:   CostCenter
Count:  1
Values: 
        Name        Count
        =========   =====
        0001        1 

Get-AzResourceGroup -Tag @{Name="CostCenter"}

Name:      EngineerBlog
Location:  East US
Resources: 
     Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US

    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001

이 예제의 명령은 미리 정의된 태그를 만들고 사용합니다.

예제 5: 구독에서 전체 태그 집합을 만들거나 업데이트합니다.

$Tags = @{"tagKey1"="tagValue1"; "tagKey2"="tagValue2"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $Tags

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             tagKey1  tagValue1
             tagKey2  tagValue2

이 명령은 {subId}를 사용하여 구독의 전체 태그 집합을 만들거나 업데이트합니다.

예제 6: 리소스에서 전체 태그 집합을 만들거나 업데이트합니다.

$Tags = @{"Dept"="Finance"; "Status"="Normal"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -Tag $Tags

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

이 명령은 {resourceId}를 사용하여 리소스의 전체 태그 집합을 만들거나 업데이트합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

미리 정의된 태그 이름을 지정합니다. 미리 정의된 새 태그를 만들려면 고유한 이름을 입력합니다. 기존 태그에 값을 추가하려면 기존 태그의 이름을 입력합니다. 기존 미리 정의된 태그에 지정된 이름이 있는 경우 New-AzTag 새 태그를 만드는 대신 해당 이름의 태그에 지정된 값(있는 경우)을 추가합니다.

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

-ResourceId

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

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

-Tag

리소스에 넣을 태그입니다.

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

-Value

미리 정의된 태그 값을 지정합니다. 미리 정의된 태그에는 여러 값이 있을 수 있지만 각 명령에는 하나의 값만 입력할 수 있습니다. 태그에 값이 없는 이름이 있을 수 있으므로 이 매개 변수는 선택 사항입니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

입력

String

Hashtable

출력

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