共用方式為


az sphere device capability

注意

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

管理裝置功能設定。

命令

名稱 Description 類型 狀態
az sphere device capability apply

暫時在連結的裝置上套用功能會話。

副檔名 GA
az sphere device capability download

從 Azure Sphere 安全性服務下載裝置功能檔案。

副檔名 GA
az sphere device capability show-attached

顯示連結裝置的目前裝置功能設定。

副檔名 GA
az sphere device capability update

更新連結裝置的裝置功能設定。

副檔名 GA

az sphere device capability apply

暫時在連結的裝置上套用功能會話。

az sphere device capability apply [--capability-file]
                                  [--none {false, true}]

範例

暫時套用裝置功能會話。

az sphere device capability apply --capability-file myCapabilities.cap

結束暫時套用的裝置功能會話。

az sphere device capability apply --none

選擇性參數

--capability-file

功能檔案的路徑和檔名。 您可以提供相對或絕對路徑。

--none -n

結束連結裝置上的暫存功能會話。

接受的值: false, true
預設值: False
全域參數
--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 capability download

從 Azure Sphere 安全性服務下載裝置功能檔案。

az sphere device capability download --catalog
                                     --resource-group
                                     [--device]
                                     [--output-file]
                                     [--type {ApplicationDevelopment, FieldServicing}]

範例

使用資源群組、目錄名稱、裝置標識碼和功能,下載裝置的「ApplicationDevelopment」功能。

az sphere device capability download --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue> --type ApplicationDevelopment --output-file myCapabilities.cap

使用資源群組、目錄名稱和裝置標識碼下載裝置的「無」功能。

az sphere device capability download --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue> --output-file myCapabilities.cap

必要參數

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

要針對此命令設定目標的裝置。 當未連結任何裝置或多個裝置時,這是必要的,以釐清要鎖定的裝置。 如果連接裝置,您可以提供裝置識別碼、IP 位址或本機 連線 標識碼。 否則,您必須只提供裝置識別碼。

值來源: az sphere device list
--output-file -of

要在其中下載功能的路徑和檔名。 如果未設定此參數,檔案會以預設名稱儲存在目前資料夾中(capability-device.cap)。

--type -t

要下載的功能空間分隔清單。 如果未設定此參數,將會下載 「無」功能。

接受的值: ApplicationDevelopment, FieldServicing
全域參數
--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 capability show-attached

顯示連結裝置的目前裝置功能設定。

az sphere device capability show-attached [--device]

範例

顯示連結裝置的裝置功能設定。

az sphere device capability show-attached

顯示指定裝置的裝置功能設定。

az sphere device capability show-attached --device <DeviceIdValue>

選擇性參數

--device -d

連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。

值來源: az sphere device list-attached
全域參數
--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 capability update

更新連結裝置的裝置功能設定。

az sphere device capability update --capability-file
                                   [--device]

範例

更新連結裝置的裝置功能設定。

az sphere device capability update --capability-file myCapabilities.cap

更新指定裝置的裝置功能組態。

az sphere device capability update --capability-file myCapabilities.cap --device <DeviceIdValue>

必要參數

--capability-file

要套用之裝置功能組態檔的路徑和檔名。

選擇性參數

--device -d

連接多個裝置時,要執行命令的裝置。 指定連結裝置的識別碼、IP 位址或本機 連線 標識碼。

值來源: az sphere device list-attached
全域參數
--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 來取得完整偵錯記錄。