az ppg

管理鄰近放置群組。

命令

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

az ppg create

建立鄰近放置群組。

az ppg create --name
              --resource-group
              [--intent-vm-sizes]
              [--location]
              [--tags]
              [--type {Standard, Ultra}]
              [--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 -n

鄰近放置群組的名稱。

--resource-group -g

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

選擇性參數

--intent-vm-sizes

指定可在鄰近放置群組中建立之虛擬機的可能大小。

--location -l

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

--tags

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

--type -t

鄰近放置群組的類型。

接受的值: Standard, Ultra

--zone -z

要在其中布建資源的可用性區域。

全域參數

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

刪除鄰近放置群組。

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

選擇性參數

--ids

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

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

鄰近放置群組的名稱。

--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 來取得完整偵錯記錄。

az ppg list

列出鄰近放置群組。

az ppg list [--resource-group]

範例

列出鄰近放置群組 （自動產生）

az ppg list --resource-group MyResourceGroup

選擇性參數

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<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 ppg show

取得鄰近放置群組。

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

範例

取得鄰近放置群組（通常與 --output 搭配使用）。 （ 自動產生 ）

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

選擇性參數

--ids

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

--include-colocation-status

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

接受的值: False, True

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

鄰近放置群組的名稱。

--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 來取得完整偵錯記錄。

az ppg update

更新鄰近放置群組。

az ppg update --name
              --resource-group
              [--add]
              [--force-string]
              [--include-colocation-status]
              [--intent-vm-sizes]
              [--remove]
              [--set]
              [--type {Standard, Ultra}]

範例

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

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

必要參數

--name -n

鄰近放置群組的名稱。

--resource-group -g

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

選擇性參數

--add

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

預設值: []

--force-string

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

預設值: False

--include-colocation-status

IncludeColocationStatus=true 可讓您擷取鄰近放置群組中所有資源的共置狀態。 預設值為 None。

--intent-vm-sizes

指定可在鄰近放置群組中建立之虛擬機的可能大小。

--remove

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

預設值: []

--set

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

預設值: []

--type -t

鄰近放置群組的類型。

接受的值: Standard, Ultra

全域參數

--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 來取得完整偵錯記錄。