共用方式為

az sphere device-group

  • 參考

注意

此參考是 Azure CLI 的 azure-sphere 延伸模組的一部分（2.45.0 版或更高版本）。 擴充功能會在您第一次執行 az sphere device-group 命令時自動安裝。 深入了解擴充功能。

管理資源群組和目錄中的裝置群組。

命令

名稱 Description 類型 狀態
az sphere device-group create

建立裝置群組。

 副檔名 GA
az sphere device-group create-defaults

建立以產品為目標的預設裝置群組。

 副檔名 GA
az sphere device-group delete

刪除指定的裝置群組。

 副檔名 GA
az sphere device-group list

列出目錄中的所有裝置群組。

 副檔名 GA
az sphere device-group show

顯示裝置群組的詳細數據。

 副檔名 GA
az sphere device-group update

更新裝置群組的詳細數據。

 副檔名 GA

az sphere device-group create

建立裝置群組。

az sphere device-group create --catalog
                              --description
                              --name
                              --product
                              --resource-group
                              [--allow-crash-dumps-collection {Disabled, Enabled}]
                              [--application-update {No3rdPartyAppUpdates, UpdateAll}]
                              [--os-feed {Retail, RetailEval}]
                              [--regional-data-boundary {EU, None}]

範例

在資源群組 「MyResourceGroup」 中建立新的裝置群組 「MyDeviceGroup」、目錄 「MyCatalog」、產品 「MyProduct」、描述 「MyDescription」 和預設區域數據界限。

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --name MyDeviceGroup --description MyDescription

在資源群組 「MyResourceGroup」 中建立新的裝置群組 「MyDeviceGroup」，目錄 「MyCatalog」， 產品 「MyProduct」 描述 「MyDescription」。，並指定區域數據界限。

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --name MyDeviceGroup --description MyDescription --regional-data-boundary EU

必要參數

--catalog -c

要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>。 來自：az sphere catalog list 的值。

--description -d

裝置群組的描述。

--name -n

裝置群組的英數位元名稱。

--product -p

產品名稱。

值來源: az sphere product list
--resource-group -g

Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name> 來設定預設群組。 來自：az group list 的值。

選擇性參數

--allow-crash-dumps-collection -cd

為此裝置群組提供 Microsoft 收集損毀傾印的同意。 如需詳細資訊，請參閱https://aka.ms/AzureSphereCrashDumpsCollection。

接受的值: Disabled, Enabled
預設值: Disabled
--application-update -a

此裝置群組的應用程式更新原則。

接受的值: No3rdPartyAppUpdates, UpdateAll
預設值: UpdateAll
--os-feed -f

要用於OS更新的OS摘要類型。

接受的值: Retail, RetailEval
預設值: Retail
--regional-data-boundary -r

此裝置群組的區域數據界限。

接受的值: EU, None
預設值: None
全域參數
--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 sphere device-group create-defaults

建立以產品為目標的預設裝置群組。

az sphere device-group create-defaults --catalog
                                       --product
                                       --resource-group

範例

在資源群組 「MyResourceGroup」、目錄 「MyCatalog」 和產品 「MyProduct」 中建立預設裝置群組。

az sphere device-group create-defaults --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

必要參數

--catalog -c

要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>。 來自：az sphere catalog list 的值。

--product -p

產品名稱。

值來源: az sphere product list
--resource-group -g

Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name> 來設定預設群組。 來自：az group list 的值。

全域參數
--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 sphere device-group delete

刪除指定的裝置群組。

az sphere device-group delete --catalog
                              --device-group
                              --product
                              --resource-group

範例

使用資源群組、目錄名稱、產品名稱和裝置組名來刪除裝置群組。

az sphere device-group delete --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

必要參數

--catalog -c

要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>。 來自：az sphere catalog list 的值。

--device-group -dg

裝置組名。

值來源: az sphere device-group list
--product -p

要刪除裝置群組的產品。

值來源: az sphere product list
--resource-group -g

Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name> 來設定預設群組。 來自：az group list 的值。

全域參數
--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 sphere device-group list

列出目錄中的所有裝置群組。

az sphere device-group list --catalog
                            --resource-group
                            [--device-group]
                            [--product]

範例

列出資源群組和目錄中的所有裝置群組。

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog

列出資源群組和目錄中具有指定名稱的所有裝置群組。

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog --device-group Development

列出資源群組、目錄和產品中的所有裝置群組。

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

必要參數

--catalog -c

要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>。 來自：az sphere catalog list 的值。

--resource-group -g

Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name> 來設定預設群組。 來自：az group list 的值。

選擇性參數

--device-group -dg

列出具有指定名稱的所有裝置群組。

--product -p

列出產品中的所有裝置群組。

值來源: az sphere product list
全域參數
--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 sphere device-group show

顯示裝置群組的詳細數據。

az sphere device-group show --catalog
                            --device-group
                            --product
                            --resource-group

範例

使用資源群組、目錄名稱、產品名稱和裝置組名來顯示裝置群組的詳細數據。

az sphere device-group show --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

必要參數

--catalog -c

要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>。 來自：az sphere catalog list 的值。

--device-group -dg

要顯示的裝置群組。

值來源: az sphere device-group list
--product -p

要顯示裝置群組的產品名稱。

值來源: az sphere product list
--resource-group -g

Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name> 來設定預設群組。 來自：az group list 的值。

全域參數
--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 sphere device-group update

更新裝置群組的詳細數據。

az sphere device-group update --catalog
                              --device-group
                              --product
                              --resource-group
                              [--allow-crash-dumps-collection {Disabled, Enabled}]
                              [--application-update {No3rdPartyAppUpdates, UpdateAll}]
                              [--description]
                              [--os-feed {Retail, RetailEval}]
                              [--regional-data-boundary {EU, None}]

範例

更新裝置群組的屬性。

az sphere device-group update --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --description NewDescription

必要參數

--catalog -c

要在其中執行這項作業的 Azure Sphere 目錄。 指定 Azure Sphere 目錄名稱。 您可以使用 來設定預設的 Azure Sphere 目錄 az config set defaults.sphere.catalog=<name>。 來自：az sphere catalog list 的值。

--device-group -dg

裝置組名。

值來源: az sphere device-group list
--product -p

產品名稱。

值來源: az sphere product list
--resource-group -g

Azure 資源群組的名稱。 您可以使用 az config set defaults.group=<name> 來設定預設群組。 來自：az group list 的值。

選擇性參數

--allow-crash-dumps-collection -cd

為此裝置群組提供 Microsoft 收集損毀傾印的同意。 如需詳細資訊，請參閱https://aka.ms/AzureSphereCrashDumpsCollection。

接受的值: Disabled, Enabled
--application-update -a

此裝置群組的應用程式更新原則。

接受的值: No3rdPartyAppUpdates, UpdateAll
--description -d

裝置群組的新描述。

--os-feed -f

要用於OS更新的OS摘要類型。

接受的值: Retail, RetailEval
--regional-data-boundary -r

此裝置群組的區域數據界限。

接受的值: EU, None
全域參數
--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 來取得完整偵錯記錄。