共用方式為

az tag

資源上的標籤管理。

命令

名稱 Description 類型 狀態
az tag add-value

建立標籤值。

 Core GA
az tag create

在特定資源上建立標記。

 Core GA
az tag delete

刪除特定資源上的標記。

 Core GA
az tag list

列出特定資源上的整個標記集。

 Core GA
az tag remove-value

刪除預先定義標籤名稱的預先定義標籤值。

 Core GA
az tag update

選擇性地更新特定資源上的標記集。

 Core GA

az tag add-value

編輯

建立標籤值。

az tag add-value --name
                 --value

範例

建立標籤值。

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

必要參數

--name -n

標記名稱。

--value

標籤值。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az tag create

編輯

在特定資源上建立標記。

具有id的 az tag create 命令會建立或更新資源、資源群組或訂用帳戶上的整個標記集。 此作業允許在指定的資源、資源群組或訂用帳戶上新增或取代整個標記集。 指定的實體最多可以有50個標籤。 請注意：『tag create』 的作用就像是 『tag init』，因此使用此命令建立的標籤是唯一在執行之後存在的標記。

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

範例

在訂用帳戶中建立標記。

az tag create --name MyTag

在訂用帳戶上建立或更新整個標記集。

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

在資源群組上建立或更新整個標記集。

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

在資源上建立或更新整個標記集。

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--name -n

要建立的標記名稱。

--resource-id

要標記之實體的資源標識碼。 可能會標記資源、資源群組或訂用帳戶。

--tags

要套用至資源的標記。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID 來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az tag delete

編輯

刪除特定資源上的標記。

具有 id 的 az tag delete 命令會刪除資源、資源群組或訂用帳戶上的整個標記集。

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

範例

從與資源沒有關聯的訂用帳戶中刪除預先定義的標籤，或沒有標籤值。

az tag delete --name MyTag

刪除訂用帳戶上的整個標記集。

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

刪除資源群組上的整個標記集。

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

刪除資源上的整個標記集。 （即使使用 --name 搭配 --resource-id 來指定單一標記）

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--name -n

要刪除的標記名稱。

--resource-id

要標記之實體的資源標識碼。 可能會標記資源、資源群組或訂用帳戶。

--yes -y

請勿提示確認。

屬性 值
預設值: False
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az tag list

編輯

列出特定資源上的整個標記集。

具有標識符的 az tag list 命令會列出資源、資源群組或訂用帳戶上的整個標記集。

az tag list [--resource-id]

範例

列出訂用帳戶上的整個標記集。

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

列出資源群組上的整個標記集。

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

列出資源上的整個標記集。

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--resource-id

要標記之實體的資源標識碼。 可能會標記資源、資源群組或訂用帳戶。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az tag remove-value

編輯

刪除預先定義標籤名稱的預先定義標籤值。

這項作業允許從現有預先定義標籤名稱的預先定義值清單中刪除值。 要刪除的值不得做為任何資源的指定標籤名稱的標記值。

az tag remove-value --name
                    --value

必要參數

--name -n

標記名稱。

--value

標籤值。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az tag update

編輯

選擇性地更新特定資源上的標記集。

具有標識符的 az tag update 命令會選擇性地更新資源、資源群組或訂用帳戶上的標記集。 此作業允許取代、合併或選擇性刪除指定資源、資源群組或訂用帳戶上的標記。 指定的實體在作業結束時最多可以有50個標記。 [取代] 選項會以新的集合取代整個現有標記集。 [合併] 選項允許新增具有新名稱的標籤，並更新具有現有名稱的標籤值。 [刪除] 選項允許根據指定的名稱或名稱/值組選擇性地刪除標記。

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

範例

選擇性地使用「合併」作業更新訂用帳戶上的標記集。

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

選擇性地將資源群組上的標記集更新為「取代」作業。

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

選擇性地使用「刪除」作業來更新資源上的標記集。

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

必要參數

--operation

更新作業。 選項為 [合併]、[取代] 和 [刪除]。

屬性 值
接受的值: Delete, Merge, Replace
--resource-id

要標記之實體的資源標識碼。 可能會標記資源、資源群組或訂用帳戶。

--tags

要更新資源上的標記。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False