Remove-AzTag
미리 정의된 Azure 태그 또는 값을 삭제합니다. | 리소스 또는 구독에서 태그의 전체 집합을 삭제합니다.
구문
RemovePredefinedTagParameterSet
Remove-AzTag
[-Name] <String>
[[-Value] <String[]>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveByResourceIdParameterSet
Remove-AzTag
-ResourceId <String>
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
RemovePredefinedTagSet: Remove-AzTag cmdlet은 구독에서 미리 정의된 Azure 태그 및 값을 삭제합니다. 미리 정의된 태그에서 특정 값을 삭제하려면 Value 매개 변수를 사용합니다. 기본적으로 Remove-AzTag 는 지정된 태그와 모든 값을 삭제합니다. 현재 리소스 또는 리소스 그룹에 적용되는 태그 또는 값은 삭제할 수 없습니다. Remove-AzTag를 사용하기 전에 Set-AzResourceGroup cmdlet의 Tag 매개 변수를 사용하여 리소스 또는 리소스 그룹에서 태그 또는 값을 삭제합니다. Remove-AzTag가 속한 Azure 태그 모듈은 미리 정의된 Azure 태그를 관리하는 데 도움이 될 수 있습니다. Azure 태그는 부서 또는 비용 센터와 같은 Azure 리소스 및 리소스 그룹을 분류하거나 리소스 및 그룹에 대한 메모 또는 의견을 추적하는 데 사용할 수 있는 이름-값 쌍입니다. 한 단계에서 태그를 정의하고 적용할 수 있지만 미리 정의된 태그를 사용하면 구독의 태그에 대한 표준적이고 일관되고 예측 가능한 이름과 값을 설정할 수 있습니다.
RemoveByResourceIdParameterSet: ResourceId가 있는 Remove-AzTag cmdlet은 리소스 또는 구독에서 전체 태그 집합을 삭제합니다.
예제
예제 1: 미리 정의된 태그 삭제
Remove-AzTag -Name "Department"
이 명령은 Department라는 미리 정의된 태그와 해당 값을 모두 삭제합니다. 태그가 리소스 또는 리소스 그룹에 적용된 경우 명령이 실패합니다.
예제 2: 미리 정의된 태그에서 값 삭제
Remove-AzTag -Name "Department" -Value "HumanResources" -PassThru
Name: Department
Count: 14
Values:
Name Count
========= =====
Finance 2
IT 12
이 명령은 미리 정의된 Department 태그에서 HumanResources 값을 삭제합니다. 태그는 삭제하지 않습니다. 값이 리소스 또는 리소스 그룹에 적용된 경우 명령이 실패합니다.
예제 3: 구독에서 태그의 전체 집합을 삭제합니다.
Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
이 명령은 {subId}를 사용하여 구독의 전체 태그 집합을 삭제합니다. "-PassThru"를 전달하지 않으면 삭제된 개체를 반환하지 않습니다.
예제 4: 리소스의 전체 태그 집합을 삭제합니다.
Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -PassThru
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
Dept Finance
Status Normal
이 명령은 {resourceId}를 사용하여 리소스의 전체 태그 집합을 삭제합니다. "-PassThru"를 전달할 때 삭제된 개체를 반환합니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
매개 변수 속성
| 형식: | IAzureContextContainer |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | AzContext, AzureRmContext, AzureCredential |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Name
제거할 미리 정의된 태그의 이름을 지정합니다. 기본적으로 Remove-AzTag 는 지정된 태그와 모든 값을 제거합니다. 선택한 값을 삭제하지만 태그를 삭제하지 않려면 Value 매개 변수를 사용합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
RemovePredefinedTagParameterSet
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-PassThru
삭제된 태그 또는 삭제된 값이 있는 결과 태그를 나타내는 개체를 반환합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ResourceId
태그가 지정된 엔터티의 리소스 식별자입니다. 리소스, 리소스 그룹 또는 구독에 태그가 지정될 수 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
RemoveByResourceIdParameterSet
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Value
미리 정의된 태그에서 지정된 값을 삭제하지만 태그는 삭제하지 않습니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
RemovePredefinedTagParameterSet
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
