az vmss extension

管理 VM 擴展集上的擴充功能。

命令

名稱	Description	類型	狀態
az vmss extension delete	從 VMSS 刪除擴充功能。	核心	GA
az vmss extension image	尋找訂用帳戶和區域的可用 VM 擴充功能。	核心	GA
az vmss extension image list	列出可用擴充功能的相關資訊。	核心	GA
az vmss extension image list-names	列出虛擬機器擴充功能映射類型。	核心	GA
az vmss extension image list-versions	列出虛擬機器擴充功能映射版本。	核心	GA
az vmss extension image show	取得虛擬機器擴充功能映射。	核心	GA
az vmss extension list	列出與 VMSS 相關聯的擴充功能。	核心	GA
az vmss extension set	將擴充功能新增至 VMSS 或更新現有的擴充功能。	核心	GA
az vmss extension show	顯示 VMSS 擴充功能的詳細資料。	核心	GA
az vmss extension upgrade	將所有 VMSS 實例的所有擴充功能更新至最新版本。	核心	GA

az vmss extension delete

從 VMSS 刪除擴充功能。

az vmss extension delete --name
                         --resource-group
                         --vmss-name
                         [--no-wait]

範例

從 VMSS 刪除擴充功能。 （自動產生）

az vmss extension delete --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

必要參數

--name -n

延伸模組的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--vmss-name

擴展集名稱。 您可以使用 來設定預設值 az configure --defaults vmss=<name> 。

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss extension list

列出與 VMSS 相關聯的擴充功能。

az vmss extension list --resource-group
                       --vmss-name

範例

列出與 VMSS 相關聯的擴充功能。 （自動產生）

az vmss extension list --resource-group MyResourceGroup --vmss-name MyVmss

必要參數

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--vmss-name

擴展集名稱。 您可以使用 來設定預設值 az configure --defaults vmss=<name> 。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss extension set

將擴充功能新增至 VMSS 或更新現有的擴充功能。

從 az vmss extension image list 取得延伸模組詳細資料。

az vmss extension set --name
                      --publisher
                      --resource-group
                      --vmss-name
                      [--enable-auto-upgrade {false, true}]
                      [--extension-instance-name]
                      [--force-update]
                      [--no-auto-upgrade {false, true}]
                      [--no-auto-upgrade-minor-version {false, true}]
                      [--no-wait]
                      [--protected-settings]
                      [--provision-after-extensions]
                      [--settings]
                      [--version]

範例

設定相依于兩個先前設定延伸模組的延伸模組。 也就是說，建立或重新映射 VMSS 實例時，只有在布建所有相依的擴充功能之後，才會布建 customScript 擴充功能。 擴充功能不需要相依于其他擴充功能，才能進行必要設定。

az vmss extension set --vmss-name my-vmss --name customScript --resource-group my-group \
    --version 2.0 --publisher Microsoft.Azure.Extensions \
    --provision-after-extensions NetworkWatcherAgentLinux VMAccessForLinux  \
    --settings '{"commandToExecute": "echo testing"}'

如果有較新版本的擴充功能可用，請新增延伸模組，並啟用平臺的自動升級。

az vmss extension set -n extName --publisher publisher --vmss-name my-vmss -g my-group \ --enable-auto-upgrade true

必要參數

--name -n

延伸模組的名稱。

值來自: az vm extension image list

--publisher

延伸模組發行者的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--vmss-name

擴展集名稱。 您可以使用 來設定預設值 az configure --defaults vmss=<name> 。

選擇性參數

--enable-auto-upgrade

指出如果有較新版本的擴充功能可用，平臺應該會自動升級延伸模組。

接受的值: false, true

--extension-instance-name

可自訂的擴充實例名稱。 預設值：延伸模組的名稱。

--force-update

強制更新，即使延伸模組組態尚未變更也一樣。

預設值: False

--no-auto-upgrade

已被取代

選項 '--no-auto-upgrade' 已被取代，將在未來的版本中移除。 請改用 '--no-auto-upgrade-minor-version'。

如果設定，即使重新部署擴充功能，擴充服務也不會自動挑選或升級至最新的次要版本。

接受的值: false, true

預設值: False

--no-auto-upgrade-minor-version

如果設定，即使重新部署擴充功能，擴充服務也不會自動挑選或升級至最新的次要版本。

接受的值: false, true

預設值: False

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--protected-settings

JSON 格式的受保護設定，例如認證等敏感性資訊。 也接受 JSON 檔案路徑。

--provision-after-extensions

延伸模組名稱的空間分隔清單，之後應該布建此延伸模組。 必須在 VM 上設定這些擴充功能。

--settings

JSON 格式的延伸模組設定。 也接受 JSON 檔案路徑。

--version

延伸模組的版本。 若要將擴充功能版本釘選到此值，請指定 --no-auto-upgrade-minor-version。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss extension show

顯示 VMSS 擴充功能的詳細資料。

az vmss extension show --name
                       --resource-group
                       --vmss-name

範例

顯示 VMSS 擴充功能的詳細資料。 （自動產生）

az vmss extension show --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

必要參數

--name -n

延伸模組的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--vmss-name

擴展集名稱。 您可以使用 來設定預設值 az configure --defaults vmss=<name> 。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss extension upgrade

將所有 VMSS 實例的所有擴充功能更新至最新版本。

az vmss extension upgrade [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]

範例

將所有擴充功能更新至最新版本。

az vmss extension upgrade -g MyResourceGroup -n MyVmss

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

擴展集名稱。 您可以使用 來設定預設值 az configure --defaults vmss=<name> 。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

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

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。