az ppg

管理鄰近放置群組。

命令

名稱	Description	類型	狀態
az ppg create	建立鄰近放置群組。	Core	GA
az ppg delete	刪除鄰近放置群組。	Core	GA
az ppg list	列出鄰近放置群組。	Core	GA
az ppg show	取得鄰近放置群組。	Core	GA
az ppg update	更新鄰近放置群組。	Core	GA

az ppg create

建立鄰近放置群組。

az ppg create --name --proximity-placement-group-name
              --resource-group
              [--intent-vm-sizes]
              [--location]
              [--ppg-type --type {Standard, Ultra}]
              [--tags]
              [--zone]

範例

建立鄰近放置群組。

az ppg create --name MyProximityPlacementGroup --resource-group MyResourceGroup

建立鄰近放置群組，並指定可建立的 VM 大小。

az ppg create --name MyProximityPlacementGroup --resource-group MyResourceGroup --intent-vm-sizes Standard_E64s_v4 Standard_M416ms_v2

建立鄰近放置群組，並指定可建立和可用性區域的 VM 大小。

az ppg create --name MyProximityPlacementGroup --resource-group MyResourceGroup --intent-vm-sizes Standard_E64s_v4 Standard_M416ms_v2 --zone 1

必要參數

--name --proximity-placement-group-name -n

鄰近放置群組的名稱。

--resource-group -g

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

選擇性參數

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

--intent-vm-sizes

指定可在鄰近放置群組中建立之虛擬機的可能大小。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--location -l

資源位置未指定時，將會使用資源群組的位置。

屬性	值
參數群組:	Parameters Arguments

--ppg-type --type -t

鄰近放置群組的類型。允許的值：標準。

屬性	值
接受的值:	Standard, Ultra

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Parameters Arguments

--zone -z

指定可以建立與鄰近放置群組相關聯的虛擬機、虛擬機擴展集或可用性設定組的可用性區域。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Parameters Arguments

全域參數

--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 ppg delete

刪除鄰近放置群組。

az ppg delete [--ids]
              [--name --proximity-placement-group-name]
              [--resource-group]
              [--subscription]

選擇性參數

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name --proximity-placement-group-name -n

鄰近放置群組的名稱。

屬性	值
參數群組:	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 ppg list

列出鄰近放置群組。

az ppg list [--max-items]
            [--next-token]
            [--resource-group]

範例

列出鄰近放置群組。

az ppg list --resource-group MyResourceGroup

選擇性參數

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

--max-items

命令輸出中要傳回的項目總數。如果可用的專案總數超過指定的值，則會在命令的輸出中提供令牌。若要繼續分頁，請在後續命令的 --next-token 自變數中提供令牌值。

屬性	值
參數群組:	Pagination Arguments

--next-token

標記，指定要開始分頁的位置。這是先前截斷回應中的令牌值。

屬性	值
參數群組:	Pagination Arguments

--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 ppg show

取得鄰近放置群組。

az ppg show [--ids]
            [--include-colocation-status {False, True}]
            [--name --proximity-placement-group-name]
            [--resource-group]
            [--subscription]

範例

取得鄰近放置群組（通常與 --output 搭配使用）。 (autogenerated)

az ppg show --name MyProximityPlacementGroup --resource-group MyResourceGroup

選擇性參數

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

--ids

屬性	值
參數群組:	Resource Id Arguments

--include-colocation-status

啟用擷取鄰近放置群組中所有資源的共置狀態。

屬性	值
接受的值:	False, True

--name --proximity-placement-group-name -n

鄰近放置群組的名稱。

屬性	值
參數群組:	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 ppg update

更新鄰近放置群組。

az ppg update --name --proximity-placement-group-name
              --resource-group
              [--add]
              [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
              [--intent-vm-sizes]
              [--ppg-type --type {Standard, Ultra}]
              [--remove]
              [--set]

範例

使用指定可建立的 VM 大小來更新鄰近放置群組。

az ppg update --name MyProximityPlacementGroup --resource-group MyResourceGroup --intent-vm-sizes Standard_E64s_v4 Standard_M416ms_v2

必要參數

--name --proximity-placement-group-name -n

鄰近放置群組的名稱。

--resource-group -g

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

選擇性參數

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

--add

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

屬性	值
參數群組:	Generic Update Arguments

--force-string

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

屬性	值
參數群組:	Generic Update Arguments
接受的值:	0, 1, f, false, n, no, t, true, y, yes

--intent-vm-sizes

指定可在鄰近放置群組中建立之虛擬機的可能大小。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--ppg-type --type -t

鄰近放置群組的類型。允許的值：標準。

屬性	值
接受的值:	Standard, Ultra

--remove

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

屬性	值
參數群組:	Generic Update Arguments

--set

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

屬性	值
參數群組:	Generic Update Arguments

全域參數

--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 ppg

命令

az ppg create

範例

必要參數

選擇性參數

az ppg delete

選擇性參數

az ppg list

範例

選擇性參數

az ppg show

範例

選擇性參數

az ppg update

範例

必要參數

選擇性參數

意見反應