共用方式為

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 目錄名稱。 您可以使用 az config set defaults.sphere.catalog=<name>來設定預設的 Azure Sphere 目錄。 來自：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。