az stack-hci-vm disk

Note

此參考是 Azure CLI 的 stack-hci-vm 擴充功能的一部分（2.15.0 版或更高版本）。 擴充功能會在您第一次執行 az stack-hci-vm disk 命令時自動安裝。 深入了解擴充功能。

使用 stack-hci-vm 管理 virtualharddisk。

命令

名稱	Description	類型	狀態
az stack-hci-vm disk attach	將磁碟連結至 VM。	Extension	GA
az stack-hci-vm disk create	建立虛擬硬碟。	Extension	GA
az stack-hci-vm disk create-from-local	喺Azure控制平面啟用Azure Local嘅data disk。	Extension	Preview
az stack-hci-vm disk delete	刪除虛擬硬碟。	Extension	GA
az stack-hci-vm disk detach	從 VM 中斷連結磁碟。	Extension	GA
az stack-hci-vm disk list	列出所有虛擬硬碟。	Extension	GA
az stack-hci-vm disk show	取得虛擬硬碟的詳細數據。	Extension	GA
az stack-hci-vm disk update	更新虛擬硬碟。	Extension	GA
az stack-hci-vm disk upload	使用 Azure 受控磁碟 SAS URL 上傳虛擬硬碟。	Extension	GA

az stack-hci-vm disk attach

將磁碟連結至 VM。

az stack-hci-vm disk attach [--disks]
                            [--ids]
                            [--name]
                            [--resource-group]
                            [--subscription]
                            [--vm-name]
                            [--yes]

範例

AttachDisk

az stack-hci-vm disk attach --resource-group "test-rg" --vm-name "test-vm" --disks "disk1" "disk2"

選擇性參數

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

--disks

受控磁碟的一或多個名稱或標識碼（以空格分隔）。

使用量：--disks “disk1” “disk2”。

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name -n

受控磁碟的名稱或標識碼。

使用方式：--name “test-disk”。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--vm-name

虛擬機器的名稱。

使用量：--vm-name “test-vm”。

屬性	值
參數群組:	Resource Id Arguments

--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/。

--verbose

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

屬性	值
預設值:	False

az stack-hci-vm disk create

建立虛擬硬碟。

az stack-hci-vm disk create --custom-location
                            --name
                            --resource-group
                            [--block-size-bytes]
                            [--disk-file-format]
                            [--download-url]
                            [--dynamic {false, true}]
                            [--location]
                            [--logical-sector-bytes]
                            [--physical-sector-bytes]
                            [--polling-interval]
                            [--size-gb]
                            [--storage-path-id]
                            [--tags]

範例

PutVirtualHardDisk

az stack-hci-vm disk create --resource-group "test-rg" --custom-location "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location" --location "West US2" --size-gb 2 --name "test-vhd" --storage-path-id "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storagecontainers/test-storagepath"

必要參數

--custom-location

擴充位置的標識碼。

--name

虛擬硬碟的名稱。

--resource-group -g

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

選擇性參數

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

--block-size-bytes

區塊大小。

--disk-file-format

虛擬硬碟的磁碟檔格式 - vhd 或 vhdx。

使用方式：--disk-file-format “vhd”。

--download-url

下載 URL。

--dynamic

布爾值，用於在虛擬硬碟上啟用動態重設大小。

屬性	值
接受的值:	false, true

--location -l

如果未指定location，則會使用資源群組的位置。

--logical-sector-bytes

邏輯扇區。

--physical-sector-bytes

實體扇區。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--size-gb

以 GB 為單位的磁碟大小。

--storage-path-id

用來儲存 VHD 之記憶體路徑的 Azure 識別碼。

--tags

以空格分隔的標記：key[=value] [key[=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 stack-hci-vm disk create-from-local

預覽

此命令處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

喺Azure控制平面啟用Azure Local嘅data disk。

az stack-hci-vm disk create-from-local --custom-location
                                       --local-vhd-path
                                       --name
                                       --resource-group
                                       [--location]
                                       [--polling-interval]
                                       [--tags]

範例

Enable a data disk on Azure Local in Azure control plane

az stack-hci-vm disk create-from-local --resource-group "test-rg" --custom-location "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location" --name "test-vhd" --local-vhd-path "C:\ClusterStorage\UserStorage_2\e35803d0bd82d61\rehome555-dd1-a95612cb-f1fa-4daa-a4fd-272844fa512c-dogfoodarc.vhdx"

必要參數

--custom-location

擴充位置的標識碼。

--local-vhd-path

本地叢集上的 VHD 檔案路徑。

--name

虛擬硬碟的名稱。

--resource-group -g

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

選擇性參數

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

--location -l

如果未指定location，則會使用資源群組的位置。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--tags

以空格分隔的標記：key[=value] [key[=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 stack-hci-vm disk delete

刪除虛擬硬碟。

az stack-hci-vm disk delete [--ids]
                            [--name]
                            [--polling-interval]
                            [--resource-group]
                            [--subscription]
                            [--yes]

範例

DeleteVirtualHardDisk

az stack-hci-vm disk delete --resource-group "test-rg" --name "test-vhd"

選擇性參數

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name

虛擬硬碟的名稱。

屬性	值
參數群組:	Resource Id Arguments

--polling-interval

長時間執行作業的ARM輪詢間隔。

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--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/。

--verbose

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

屬性	值
預設值:	False

az stack-hci-vm disk detach

從 VM 中斷連結磁碟。

az stack-hci-vm disk detach --resource-group
                            --vm-name
                            [--name]
                            [--yes]

範例

DetachDisk

az stack-hci-vm disk detach --resource-group "test-rg" --vm-name "test-vm" --name "test-disk"

必要參數

--resource-group -g

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

--vm-name

虛擬機器的名稱。

使用量：--vm-name “test-vm”。

選擇性參數

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

--name

受控磁碟的名稱或標識碼。

使用方式：--name “test-disk”。

--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 stack-hci-vm disk list

列出所有虛擬硬碟。

az stack-hci-vm disk list [--resource-group]

範例

ListVirtualHardDiskByResourceGroup

az stack-hci-vm disk list --resource-group "test-rg"

ListVirtualHardDiskByResourceGroup

az stack-hci-vm disk list

選擇性參數

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

--resource-group -g

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

全域參數

--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 stack-hci-vm disk show

取得虛擬硬碟的詳細數據。

az stack-hci-vm disk show [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]

範例

GetVirtualHardDisk

az stack-hci-vm disk show --resource-group "test-rg" --name "test-vhd"

選擇性參數

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name

虛擬硬碟的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

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

--query

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

--verbose

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

屬性	值
預設值:	False

az stack-hci-vm disk update

更新虛擬硬碟。

az stack-hci-vm disk update [--add]
                            [--force-string]
                            [--ids]
                            [--name]
                            [--remove]
                            [--resource-group]
                            [--set]
                            [--size-gb]
                            [--subscription]
                            [--tags]

範例

UpdateVirtualHardDisk

az stack-hci-vm disk update --resource-group "test-rg" --tags additionalProperties="sample" --name "test-vhd"

選擇性參數

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

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例： --add property.listProperty <key=value, string or JSON string>.

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

屬性	值
參數群組:	Generic Update Arguments
預設值:	False

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name

虛擬硬碟的名稱。

屬性	值
參數群組:	Resource Id Arguments

--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--set

指定要設定的屬性路徑和值，以更新物件。 範例： --set property1.property2=<value>.

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--size-gb

以 GB 為單位的磁碟大小。

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--tags

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

全域參數

--debug

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

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

--query

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

--verbose

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

屬性	值
預設值:	False

az stack-hci-vm disk upload

使用 Azure 受控磁碟 SAS URL 上傳虛擬硬碟。

az stack-hci-vm disk upload [--ids]
                            [--name]
                            [--resource-group]
                            [--subscription]
                            [--target-url]

範例

PostVirtualHardDisk

az stack-hci-vm disk upload --resource-group "test-rg"  --target-url "<sas url insert>"

選擇性參數

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name

虛擬硬碟的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--target-url

Azure 受控磁碟的 SAS URL。

使用方式：--target-url “sas-url”。

全域參數

--debug

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

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

--query

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

--verbose

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

屬性	值
預設值:	False