New-AzTag
미리 정의된 Azure 태그를 만들거나 기존 태그에 값을 추가합니다. | 리소스 또는 구독에서 전체 태그 집합을 만들거나 업데이트합니다.
Syntax
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을 실행하기 전에 확인 메시지가 표시됩니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
미리 정의된 태그 이름을 지정합니다. 미리 정의된 새 태그를 만들려면 고유한 이름을 입력합니다. 기존 태그에 값을 추가하려면 기존 태그의 이름을 입력합니다. 기존 미리 정의된 태그에 지정된 이름이 있는 경우 New-AzTag 는 지정된 값(있는 경우)을 새 태그를 만드는 대신 해당 이름의 태그에 추가합니다.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
태그가 지정된 엔터티의 리소스 식별자입니다. 리소스, 리소스 그룹 또는 구독에 태그가 지정될 수 있습니다.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
리소스에 넣을 태그입니다.
| Type: | Hashtable |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Value
미리 정의된 태그 값을 지정합니다. 미리 정의된 태그에는 여러 값이 있을 수 있지만 각 명령에는 하나의 값만 입력할 수 있습니다. 태그에 값이 없는 이름이 있을 수 있으므로 이 매개 변수는 선택 사항입니다.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
출력
Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource