Delen via


az tag

Tagbeheer voor een resource.

Opdracht

Name Description Type Status
az tag add-value

Maak een tagwaarde.

Basis GA
az tag create

Tags maken voor een specifieke resource.

Basis GA
az tag delete

Tags voor een specifieke resource verwijderen.

Basis GA
az tag list

De volledige set tags voor een specifieke resource weergeven.

Basis GA
az tag remove-value

Hiermee verwijdert u een vooraf gedefinieerde tagwaarde voor een vooraf gedefinieerde tagnaam.

Basis GA
az tag update

Werk de set tags voor een specifieke resource selectief bij.

Basis GA

az tag add-value

Maak een tagwaarde.

az tag add-value --name
                 --value

Voorbeelden

Maak een tagwaarde.

az tag add-value --name MyTag --value MyValue

Vereiste parameters

--name -n

De tagnaam.

--value

De tagwaarde.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az tag create

Tags maken voor een specifieke resource.

Met de opdracht az tag create met een id wordt de hele set tags voor een resource, resourcegroep of abonnement gemaakt of bijgewerkt. Met deze bewerking kunt u de hele set tags toevoegen of vervangen voor de opgegeven resource, resourcegroep of abonnement. De opgegeven entiteit kan maximaal 50 tags bevatten. Let op: 'tag create' fungeert als een 'tag init', vandaar dat tags die met deze opdracht zijn gemaakt, de enige zijn die aanwezig zijn na de uitvoering.

az tag create [--name]
              [--resource-id]
              [--tags]

Voorbeelden

Maak een tag in het abonnement.

az tag create --name MyTag

Maak of werk de hele set tags voor een abonnement bij.

az tag create --resource-id /subscriptions/{subId} --tags Dept=Finance Status=Normal

Maak of werk de hele set tags in een resourcegroep bij.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --tags Dept=Finance Status=Normal

Maak of werk de hele set tags voor een resource bij.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --tags Dept=Finance Status=Normal

Optionele parameters

--name -n

De naam van de tag die moet worden gemaakt.

--resource-id

De resource-id voor de entiteit die wordt getagd. Een resource, een resourcegroep of een abonnement kan worden getagd.

--tags

De tags die moeten worden toegepast op de resource.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az tag delete

Tags voor een specifieke resource verwijderen.

Met de opdracht az tag delete met een id wordt de hele set tags voor een resource, resourcegroep of abonnement verwijderd.

az tag delete [--name]
              [--resource-id]
              [--yes]

Voorbeelden

Verwijder een vooraf gedefinieerde tag uit het abonnement dat niet is gekoppeld aan een resource of zonder tagwaarden.

az tag delete --name MyTag

Verwijder de volledige set tags voor een abonnement.

az tag delete --resource-id /subscriptions/{sub-id}

Verwijder de hele set tags in een resourcegroep.

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Verwijder de hele set tags op een resource. (Zelfs met behulp van --name samen met --resource-id om één tag op te geven)

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Optionele parameters

--name -n

De naam van de tag die moet worden verwijderd.

--resource-id

De resource-id voor de entiteit die wordt getagd. Een resource, een resourcegroep of een abonnement kan worden getagd.

--yes -y

Niet vragen om bevestiging.

Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az tag list

De volledige set tags voor een specifieke resource weergeven.

De opdracht az tag list met een id bevat de volledige set tags voor een resource, resourcegroep of abonnement.

az tag list [--resource-id]

Voorbeelden

De volledige set tags voor een abonnement weergeven.

az tag list --resource-id /subscriptions/{sub-id}

De volledige set tags voor een resourcegroep weergeven.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Geef de volledige set tags op een resource weer.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Optionele parameters

--resource-id

De resource-id voor de entiteit die wordt getagd. Een resource, een resourcegroep of een abonnement kan worden getagd.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az tag remove-value

Hiermee verwijdert u een vooraf gedefinieerde tagwaarde voor een vooraf gedefinieerde tagnaam.

Met deze bewerking kunt u een waarde verwijderen uit de lijst met vooraf gedefinieerde waarden voor een bestaande vooraf gedefinieerde tagnaam. De waarde die wordt verwijderd, mag niet worden gebruikt als tagwaarde voor de opgegeven tagnaam voor een resource.

az tag remove-value --name
                    --value

Vereiste parameters

--name -n

De tagnaam.

--value

De tagwaarde.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az tag update

Werk de set tags voor een specifieke resource selectief bij.

Met de opdracht az tag update with an id wordt de set tags voor een resource, resourcegroep of abonnement selectief bijgewerkt. Met deze bewerking kunt u tags voor de opgegeven resource, resourcegroep of abonnement vervangen, samenvoegen of selectief verwijderen. De opgegeven entiteit kan maximaal 50 tags aan het einde van de bewerking hebben. De optie Vervangen vervangt de hele set bestaande tags door een nieuwe set. Met de optie 'samenvoegen' kunt u tags met nieuwe namen toevoegen en de waarden van tags bijwerken met bestaande namen. Met de optie Verwijderen kunnen tags selectief worden verwijderd op basis van namen of naam-/waardeparen.

az tag update --operation {Delete, Merge, Replace}
              --resource-id
              --tags

Voorbeelden

Werk de set tags voor een abonnement selectief bij met bewerking 'samenvoegen'.

az tag update --resource-id /subscriptions/{sub-id} --operation merge --tags key1=value1 key3=value3

Werk de set tags in een resourcegroep selectief bij met bewerking vervangen.

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --operation replace --tags key1=value1 key3=value3

Werk de set tags op een resource selectief bij met 'delete'-bewerking.

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --operation delete --tags key1=value1

Vereiste parameters

--operation

De updatebewerking. Opties zijn Samenvoegen, Vervangen en Verwijderen.

Geaccepteerde waarden: Delete, Merge, Replace
--resource-id

De resource-id voor de entiteit die wordt getagd. Een resource, een resourcegroep of een abonnement kan worden getagd.

--tags

De tags die moeten worden bijgewerkt voor de resource.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.