다음을 통해 공유


Remove-AzTag

미리 정의된 Azure 태그 또는 값을 삭제합니다. | 리소스 또는 구독에서 태그의 전체 집합을 삭제합니다.

구문

Remove-AzTag
      [-Name] <String>
      [[-Value] <String[]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzTag
      [-PassThru]
      -ResourceId <String>
      [-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"를 전달할 때 삭제된 oject를 반환합니다.

매개 변수

-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

제거할 미리 정의된 태그의 이름을 지정합니다. 기본적으로 Remove-AzTag 는 지정된 태그와 모든 값을 제거합니다. 선택한 값을 삭제하지만 태그를 삭제하지 않려면 Value 매개 변수를 사용합니다.

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

-PassThru

삭제된 태그 또는 삭제된 값이 있는 결과 태그를 나타내는 개체를 반환합니다.

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

-ResourceId

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

형식:String
Position:Named
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

String[]

SwitchParameter

출력

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