az connectedvmware vm extension

注意

此參考是 Azure CLI (2.0.67 版或更新版本的 connectedvmware 擴充功能的一部分) 。 當您第一次執行 az connectedvmware vm extension 命令時,擴充功能會自動安裝。 深入了解延伸模組。

使用 connectedvmware 管理 VM 擴充功能。

命令

az connectedvmware vm extension create

要建立延伸模組的作業。

az connectedvmware vm extension delete

要刪除延伸模組的作業。

az connectedvmware vm extension list

取得非 Azure VM 之所有擴充功能的作業。

az connectedvmware vm extension show

取得延伸模組的作業。

az connectedvmware vm extension update

更新延伸模組的作業。

az connectedvmware vm extension create

要建立延伸模組的作業。

az connectedvmware vm extension create --location
                                       --name
                                       --resource-group
                                       --vm-name
                                       [--auto-upgrade-minor {false, true}]
                                       [--force-update-tag]
                                       [--inst-handler-version]
                                       [--instance-view-type]
                                       [--no-wait]
                                       [--protected-settings]
                                       [--publisher]
                                       [--settings]
                                       [--tags]
                                       [--type]
                                       [--type-handler-version]

範例

建立 VM 擴充功能

az connectedvmware vm extension create --name "CustomScriptExtension" --location "eastus2euap" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version "1.10" --vm-name "vm name" --resource-group "myResourceGroup"

必要參數

--location -l

位置。 值的來源:az account list-locations。 您可以使用 az configure --defaults location=<location> 來設定預設位置。

--name

vm 擴充功能的名稱。

--resource-group -g

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

--vm-name

應建立或更新擴充功能的 VM 名稱。

選擇性參數

--auto-upgrade-minor

指出擴充功能是否應該在部署時間使用較新的次要版本。 不過,部署之後,除非重新部署延伸模組,否則延伸模組將不會升級次要版本,即使此屬性設定為 true 亦然。

接受的值: false, true
--force-update-tag

延伸模組處理常式應該如何強制更新,即使延伸模組組態尚未變更也一樣。

--inst-handler-version

指定腳本處理常式的版本。

--instance-view-type

指定延伸模組的類型;範例為 「CustomScriptExtension」。

--no-wait

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

--protected-settings

此延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。 預期值:json-string/json-file/@json-file。

--publisher

擴充處理常式發行者的名稱。

--settings

擴充功能的 Json 格式化公用設定。 預期值:json-string/json-file/@json-file。

--tags

空格分隔標記:key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

--type

指定延伸模組的類型;範例為 「CustomScriptExtension」。

--type-handler-version

指定腳本處理常式的版本。

az connectedvmware vm extension delete

要刪除延伸模組的作業。

az connectedvmware vm extension delete --name
                                       --resource-group
                                       --vm-name
                                       [--no-wait]
                                       [--yes]

範例

刪除 VM 擴充功能

az connectedvmware vm extension delete --name "vm extension name" --vm-name "vm name" --resource-group "myResourceGroup"

必要參數

--name

vm 擴充功能的名稱。

--resource-group -g

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

--vm-name

應刪除擴充功能之 VM 的名稱。

選擇性參數

--no-wait

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

--yes -y

不提示確認。

az connectedvmware vm extension list

取得非 Azure VM 之所有擴充功能的作業。

az connectedvmware vm extension list --resource-group
                                     --vm-name
                                     [--expand]

範例

取得所有 VM 擴充功能

az connectedvmware vm extension list --vm-name "vm name" --resource-group "myResourceGroup"

必要參數

--resource-group -g

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

--vm-name

包含擴充功能的 VM 名稱。

選擇性參數

--expand

要套用至作業的展開運算式。

az connectedvmware vm extension show

取得延伸模組的作業。

az connectedvmware vm extension show --name
                                     --resource-group
                                     --vm-name

範例

取得 VM 擴充功能

az connectedvmware vm extension show --name "CustomScriptExtension" --vm-name "vm name" --resource-group "myResourceGroup"

必要參數

--name

vm 擴充功能的名稱。

--resource-group -g

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

--vm-name

包含擴充功能的 VM 名稱。

az connectedvmware vm extension update

更新延伸模組的作業。

az connectedvmware vm extension update --name
                                       --resource-group
                                       --vm-name
                                       [--auto-upgrade-minor {false, true}]
                                       [--force-update-tag]
                                       [--no-wait]
                                       [--protected-settings]
                                       [--publisher]
                                       [--settings]
                                       [--tags]
                                       [--type]
                                       [--type-handler-version]

範例

更新 VM 擴充功能

az connectedvmware vm extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --vm-name "vm name" --resource-group "myResourceGroup"

必要參數

--name

vm 擴充功能的名稱。

--resource-group -g

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

--vm-name

應建立或更新擴充功能的 VM 名稱。

選擇性參數

--auto-upgrade-minor

指出擴充功能是否應該在部署時間使用較新的次要版本。 不過,部署之後,除非重新部署延伸模組,否則延伸模組將不會升級次要版本,即使此屬性設定為 true 亦然。

接受的值: false, true
--force-update-tag

延伸模組處理常式應該如何強制更新,即使延伸模組組態尚未變更也一樣。

--no-wait

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

--protected-settings

此延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。 預期值:json-string/json-file/@json-file。

--publisher

擴充處理常式發行者的名稱。

--settings

擴充功能的 Json 格式化公用設定。 預期值:json-string/json-file/@json-file。

--tags

空格分隔標記:key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

--type

指定延伸模組的類型;範例為 「CustomScriptExtension」。

--type-handler-version

指定腳本處理常式的版本。