Címkék alkalmazása Azure PowerShell

Cikk
09/26/2024

Ez a cikk azt ismerteti, hogyan címkézhet meg erőforrásokat, erőforráscsoportokat és előfizetéseket Azure PowerShell. A címkékre vonatkozó javaslatokért és korlátozásokért lásd: Címkék használata az Azure-erőforrások és a felügyeleti hierarchia rendszerezéséhez.

Címkék alkalmazása

Azure PowerShell két parancsot kínál címkék alkalmazásához: New-AzTag és Update-AzTag. A modul 1.12.0-s vagy újabb verziójával kell rendelkeznie Az.Resources . A verziót a használatával Get-InstalledModule -Name Az.Resourcesellenőrizheti. Telepítheti a modult, vagy telepítheti Azure PowerShell 3.6.1-es vagy újabb verzióját.

A New-AzTag az erőforrás, az erőforráscsoport vagy az előfizetés összes címkéjének lecserélése. Amikor meghívja a parancsot, adja meg a címkézni kívánt entitás erőforrás-azonosítóját.

Az alábbi példa címkéket alkalmaz egy tárfiókra:

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

Amikor a parancs befejeződik, figyelje meg, hogy az erőforrás két címkét tartalmaz.

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

Ha ismét futtatja a parancsot, de ezúttal különböző címkékkel, figyelje meg, hogy a korábbi címkék eltűnnek.

$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

Ha címkéket szeretne hozzáadni egy már címkéket tartalmazó erőforráshoz, használja a következőt Update-AzTag: . Állítsa a paramétert a -Operation értékre Merge.

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

Figyelje meg, hogy a meglévő címkék a két új címke hozzáadásával nőnek.

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

Minden címkenév csak egy értékkel rendelkezhet. Ha új értéket ad meg egy címkéhez, akkor is lecseréli a régi értéket, ha az egyesítési műveletet használja. Az alábbi példa a címkét StatusNormálrólZöldre módosítja.

$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

Amikor a paramétert a -Operation értékre Replaceállítja, az új címkekészlet lecseréli a meglévő címkéket.

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

Csak az új címkék maradnak az erőforráson.

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

Ugyanezek a parancsok erőforráscsoportokkal vagy előfizetésekkel is működnek. Adja meg őket a címkézni kívánt erőforráscsoport vagy előfizetés azonosítójában.

Ha új címkekészletet szeretne hozzáadni egy erőforráscsoporthoz, használja a következőt:

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

Egy erőforráscsoport címkéinek frissítéséhez használja a következőt:

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

Ha új címkekészletet szeretne hozzáadni egy előfizetéshez, használja a következőt:

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

Az előfizetés címkéinek frissítéséhez használja a következőt:

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

Előfordulhat, hogy egy erőforráscsoportban egynél több erőforrás szerepel ugyanazzal a névvel. Ebben az esetben az egyes erőforrásokat a következő parancsokkal állíthatja be:

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

Egy erőforrás, erőforráscsoport vagy előfizetés címkéinek lekéréséhez használja a Get-AzTag parancsot, és adja meg az entitás erőforrás-azonosítóját.

Az erőforrás címkéinek megtekintéséhez használja a következőt:

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

Egy erőforráscsoport címkéinek megtekintéséhez használja a következőt:

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

Az előfizetés címkéinek megtekintéséhez használja a következőt:

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

Lista címke szerint

Ha egy adott címkenévvel és értékkel rendelkező erőforrásokat szeretne lekérni, használja a következőt:

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

Ha egy adott címkenévvel rendelkező erőforrásokat szeretne lekérni bármilyen címkeértékkel, használja a következőt:

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

Ha egy adott címkenévvel és értékkel rendelkező erőforráscsoportokat szeretne lekérni, használja a következőt:

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

Címkék eltávolítása

Adott címkék eltávolításához használja a következőt Update-AzTag-OperationDelete: . Adja át a törölni kívánt címkék erőforrás-azonosítóit.

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

A megadott címkék el lesznek távolítva.

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

Az összes címke eltávolításához használja a Remove-AzTag parancsot.

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

Következő lépések

Nem minden erőforrástípus támogatja a címkéket. Annak megállapításához, hogy alkalmazhat-e címkét egy erőforrástípusra, tekintse meg az Azure-erőforrások címkézési támogatását ismertető cikket.
A címkézési stratégia implementálásával kapcsolatos javaslatokért lásd: Erőforrás-elnevezési és címkézési döntési útmutató.
A címkékre vonatkozó javaslatokért és korlátozásokért lásd: Címkék használata az Azure-erőforrások és a felügyeleti hierarchia rendszerezéséhez.

Megosztás a következőn keresztül:

Címkék alkalmazása Azure PowerShell