Update-AzTag
리소스 또는 구독에서 태그 집합을 선택적으로 업데이트합니다.
Syntax
Update-AzTag
[-ResourceId] <String>
[-Tag] <Hashtable>
[-Operation] <TagPatchOperation>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
ResourceId가 있는 Update-AzTag cmdlet은 리소스 또는 구독에서 태그 집합을 선택적으로 업데이트합니다. 이 작업을 통해 지정된 리소스 또는 구독에서 태그를 대체, 병합 또는 선택적으로 삭제할 수 있습니다. 지정된 엔터티는 작업이 끝날 때 최대 50개의 태그를 가질 수 있습니다. 'replace' 옵션은 기존 태그의 전체 집합을 새 집합으로 바꿉니다. '병합' 옵션을 사용하면 새 이름으로 태그를 추가하고 기존 이름으로 태그 값을 업데이트할 수 있습니다. 'delete' 옵션을 사용하면 지정된 이름 또는 이름/값 쌍에 따라 태그를 선택적으로 삭제할 수 있습니다.
예제
예제 1: "병합" 작업으로 구독의 태그 집합을 선택적으로 업데이트합니다.
$mergedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $mergedTags -Operation Merge
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
key1 value1
key2 value2
key3 value3이 명령은 구독의 태그 집합을 "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"와 병합합니다.
예제 2: "바꾸기" 작업으로 구독의 태그 집합을 선택적으로 업데이트합니다.
$replacedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $replacedTags -Operation Replace
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
key1 value1
key3 value3이 명령은 구독의 태그 집합을 "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"로 바꿉니다.
예제 3: "삭제" 작업을 사용하여 구독의 태그 집합을 선택적으로 업데이트합니다.
$deletedTags = @{"key1"="value1"}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $deletedTags -Operation Delete
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
key3 value3이 명령은 "xxxxxxxx-xx"를 사용하여 구독의 태그 집합을 삭제합니다.
매개 변수
-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 |
-Operation
업데이트 작업입니다. 옵션은 병합, 바꾸기 및 삭제입니다.
| Type: | TagPatchOperation |
| Accepted values: | Merge, Replace, Delete |
| Position: | 2 |
| 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 |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |