다음을 통해 공유

Azure PowerShell을 사용하여 태그 적용

이 문서에서는 Azure PowerShell을 사용하여 리소스, 리소스 그룹 및 구독에 태그를 지정하는 방법을 설명합니다. 태그 권장 사항 및 제한 사항은 태그를 사용하여 Azure 리소스 및 관리 계층 구조를 구성하는 방법을 참조하세요.

태그 적용

Azure PowerShell은 태그를 적용하는 두 가지 명령 인 New-AzTag 및 Update-AzTag를 제공합니다. 모듈 1.12.0 버전 이상이 있어야 합니다 Az.Resources . 을 Get-InstalledModule -Name Az.Resources사용하여 버전을 확인할 수 있습니다. 해당 모듈을 설치하거나 Azure PowerShell 버전 3.6.1 이상을 설치할 수 있습니다.

리소스 New-AzTag , 리소스 그룹 또는 구독의 모든 태그를 바꿉니다. 명령을 호출할 때 태그를 지정할 엔터티의 리소스 ID를 전달합니다.

다음 예제에서는 스토리지 계정에 태그 집합을 적용합니다.

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

명령이 완료되면 리소스에 두 개의 태그가 있습니다.

Properties :
        Name    Value
        ======  =======
        Dept    Finance
        Status  Normal

명령을 다시 실행하지만 이번에는 다른 태그를 사용하여 이전 태그가 사라지는 것을 확인합니다.

$tags = @{"Team"="Compliance"; "Environment"="Production"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

Properties :
        Name         Value
        ===========  ==========
        Environment  Production
        Team         Compliance

이미 태그가 있는 리소스에 태그를 추가하려면 .를 사용합니다 Update-AzTag. -Operation 매개 변수를 Merge로 설정합니다.

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

기존 태그는 두 개의 새 태그를 추가하여 증가합니다.

Properties :
        Name         Value
        ===========  ==========
        Status       Normal
        Dept         Finance
        Team         Compliance
        Environment  Production

각 태그 이름에는 하나의 값만 있을 수 있습니다. 태그에 새 값을 제공하는 경우 병합 작업을 사용하는 경우에도 이전 값을 대체합니다. 다음 예제에서는 태그를 Status기본 에서 녹색으로 변경합니다.

$tags = @{"Status"="Green"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

매개 변수를 -OperationReplace설정하면 새 태그 집합이 기존 태그를 대체합니다.

$tags = @{"Project"="ECommerce"; "CostCenter"="00123"; "Team"="Web"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Replace

새 태그만 리소스에 남아 있습니다.

Properties :
        Name        Value
        ==========  =========
        CostCenter  00123
        Team        Web
        Project     ECommerce

동일한 명령은 리소스 그룹 또는 구독에서도 작동합니다. 태그를 지정할 리소스 그룹 또는 구독에 대한 식별자를 전달합니다.

리소스 그룹에 새 태그 집합을 추가하려면 다음을 사용합니다.

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
New-AzTag -ResourceId $resourceGroup.ResourceId -tag $tags

리소스 그룹에 대한 태그를 업데이트하려면 다음을 사용합니다.

$tags = @{"CostCenter"="00123"; "Environment"="Production"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
Update-AzTag -ResourceId $resourceGroup.ResourceId -Tag $tags -Operation Merge

구독에 새 태그 집합을 추가하려면 다음을 사용합니다.

$tags = @{"CostCenter"="00123"; "Environment"="Dev"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
New-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags

구독에 대한 태그를 업데이트하려면 다음을 사용합니다.

$tags = @{"Team"="Web Apps"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Update-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags -Operation Merge

리소스 그룹에 이름이 같은 리소스가 두 개 이상 있을 수 있습니다. 이 경우 다음 명령을 사용하여 각 리소스를 설정할 수 있습니다.

$resource = Get-AzResource -ResourceName sqlDatabase1 -ResourceGroupName examplegroup
$resource | ForEach-Object { Update-AzTag -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $_.ResourceId -Operation Merge }

태그 나열

리소스, 리소스 그룹 또는 구독에 대한 태그를 가져오려면 Get-AzTag 명령을 사용하고 엔터티의 리소스 ID를 전달합니다.

리소스에 대한 태그를 보려면 다음을 사용합니다.

$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Get-AzTag -ResourceId $resource.id

리소스 그룹에 대한 태그를 보려면 다음을 사용합니다.

$resourceGroup = Get-AzResourceGroup -Name demoGroup
Get-AzTag -ResourceId $resourceGroup.ResourceId

구독에 대한 태그를 보려면 다음을 사용하세요.

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Get-AzTag -ResourceId "/subscriptions/$subscription"

태그별 목록

특정 태그 이름 및 값이 있는 리소스를 얻으려면 다음을 사용합니다.

(Get-AzResource -Tag @{ "CostCenter"="00123"}).Name

태그 값이 어떤 것이든 특정 태그 이름을 가진 리소스를 가져오려면 다음을 사용합니다.

(Get-AzResource -TagName "Dept").Name

특정 태그 이름 및 값이 있는 리소스 그룹을 얻으려면 다음을 사용합니다.

(Get-AzResourceGroup -Tag @{ "CostCenter"="00123" }).ResourceGroupName

태그 제거

특정 태그를 제거하려면 Update-AzTag를 사용하고 -Operation을 Delete로 설정합니다. 삭제하려는 태그의 리소스 ID를 전달합니다.

$removeTags = @{"Project"="ECommerce"; "Team"="Web"}
$resource = Get-AzResource -Name demostorage -ResourceGroup demoGroup
Update-AzTag -ResourceId $resource.id -Tag $removeTags -Operation Delete

지정된 태그가 제거됩니다.

Properties :
        Name        Value
        ==========  =====
        CostCenter  00123

모든 태그를 제거하려면 Remove-AzTag 명령을 사용합니다.

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Remove-AzTag -ResourceId "/subscriptions/$subscription"

다음 단계

  • Last updated on