裝置
管理 Azure 球體裝置。
| 操作 | 描述 |
|---|---|
| 應用程式 | 變更裝置上應用程式的狀態。 |
| 能力 | 管理裝置功能。 |
| 證書 | 管理裝置證書存放區。 |
| 索賠 | 向 Azure 球體租使用者宣告先前未宣告的裝置。 |
| enable-cloud-test | 設定裝置以停用偵錯和接收更新。 |
| enable-development | 設定裝置以進行本機偵錯。 |
| 圖像 | 管理裝置的影像。 |
| 清單 | 顯示租使用者中的所有裝置。 |
| list-attached | 清單 連接的裝置。 |
| 製造狀態 | 管理附加裝置的製造狀態。 |
| 網路 | 提供裝置上網路介面狀態的相關信息。 |
| 恢復 | 使用特殊修復模式將新的韌體載入裝置。 |
| rescan-attached | Rescans 連接的裝置做為疑難解答協助 (Windows 僅) 。 |
| 重新啟動 | 重新啟動連接的裝置。 |
| 顯示 | 顯示有關裝置更新設定的詳細數據。 |
| 顯示附加 | 顯示裝置本身所附加裝置的詳細數據。 |
| show-count | 顯示租使用者中的裝置總數。 |
| show-deployment-status | 顯示最新部署更新的狀態。 |
| show-os-version | 顯示本機裝置操作系統版本。 |
| 側載 | 將影像載入到附加的裝置上。 |
| 更新 | 將裝置放在特定裝置群組中，以 匯報 裝置。 |
| 無線 | 管理裝置的 Wi-Fi 設定。 |
應用程式
管理裝置上的應用程式。
許多應用程式選項都需要 app 的 功能，您可以使用 azsphere 裝置啟用開發來取得這項功能。 若要啟動、停止或偵錯 SDK 簽署的應用程式或是已簽署生產狀態的應用程式，裝置必須具備 app 的 功能。
您可以使用 azsphere 裝置應用程式停止 ，以及 azsphere 裝置應用程式開始 重新啟動支援即時執行的應用程式，以判斷其執行的即時核心。
| 操作 | 描述 |
|---|---|
| show-memory-stats | 顯示附加裝置上應用程式的記憶體統計數據。 |
| 顯示配額 | 顯示裝置上目前應用程式所使用的儲存空間量。 |
| 顯示狀態 | 傳回裝置上目前應用程式的狀態。 |
| 開始 | 啟動裝置上載入的應用程式。 |
| 停止 | 停止在裝置上執行的應用程式。 |
app show-memory-stats
顯示附加裝置上應用程式的記憶體統計數據。 只有已設定 app的裝置 功能時，才能使用此命令。 若已設定 堆處理記憶體配置追蹤 ，則會顯示其他資訊。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device app show-memory-stats
-------------- -------------
Name Usage (bytes)
============================
Total 434176
User Mode 147456
Peak User Mode 147456
-------------- -------------
應用程式顯示配額
顯示已附加裝置上配置及使用中的可靜音儲存空間量。
您在應用程式指令清單中設定可靜音儲存配額，且 Azure 球體 OS 會在設定檔案的區段時強制執行配額。 因此，如果您減少 MutableStorage 值，使用中的儲存空間量不會變更，但回報的配置值會有所不同。 例如，如果應用程式已使用 16 KB，而您將值變更 MutableStorage 為 8 KB，則會設定應用程式使用 16 KB 且設定 8 KB 的命令報表。 數據會保留在裝置上。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --元件-id | Guid | 指定取得配額資訊的元件標識碼。 如果省略，會顯示所有元件的配額資訊。 |
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.
應用程式顯示狀態
顯示裝置上應用程式的目前狀態。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --元件-id | Guid | 指定要顯示狀態之元件的識別碼。 如果省略，則會顯示所有元件的狀態。 |
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running
應用程式開始
在裝置上啟動應用程式。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --偵錯模式 | 布爾 | 啟動偵錯應用程式。 必須 --component-id 提供。 |
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -i， --元件-id | Guid | 指定要啟動之元件的識別碼。 如果省略，會啟動所有應用程式。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core : High-level
應用程式停止
停止裝置上的應用程式。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --元件-id | Guid | 指定要停止的元件標識碼。 如果省略，會停止所有應用程式。 |
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped
能力
管理裝置功能。 裝置功能決定可以在個別 Azure 球體裝置上執行的作業。
裝置功能是使用 azsphere 裝置功能下載 命令，以檔案的形式從 Azure 球體安全性服務下載。 您可以使用 azsphere 裝置功能更新 命令，將裝置功能設定套用至附加的 Azure 球體裝置，而且您可以使用 azsphere 裝置功能選 取命令來建立維護會話。 如需裝置功能的詳細資訊，請參閱 裝置功能和通訊。
| 操作 | 描述 |
|---|---|
| 下載 | 從 Azure 球體安全性服務下載裝置功能設定。 |
| 選擇 | 選取下載的功能檔案以用於維護會話。 |
| 顯示附加 | 顯示附加裝置的功能設定。 |
| 更新 | 將裝置功能設定套用至附加的裝置。 |
功能下載
從 Azure 球體安全性服務下載裝置功能。
App此功能可讓您側載 SDK 簽署的應用程式，並啟動、停止、偵錯或刪除裝置上的任何應用程式。 如果沒有 app 其他 功能，則只有載入雲端的應用程式才能載入並啟動、停止、偵錯和刪除。 App功能會套用為 azsphere 裝置啟用開發命令的一部分。
下載 fieldServicing 功能會產生一個檔案，其中包含單一 Azure 球體裝置的功能。 fieldServicing 功能檔案會下載到您的本機計算機，並可與 azsphere 裝置功能選取命令搭配使用。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --類型 | 功能類型 | 指定要下載的裝置功能類型。 值為 app、fieldServicing 或無。 [ 無 ] 可移除 app 的 功能或 欄位伺服器功能 。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定執行命令的裝置。 附加多個裝置或未連接任何裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以為未連接的裝置提供裝置標識碼，也可以指定附加裝置的IP位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| --目的地 | 字串 | 指定儲存功能設定的路徑和檔名。 包含絕對或相對路徑。 如果您未提供路徑，命令會使用裝置ID.cap>的前八個字元的命名慣例<功能，><將檔案儲存在本機目錄中。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
--------------------------------------------
Result
============================================
C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
--------------------------------------------
功能選取
選取功能檔案以搭配附加的 Azure 球體裝置使用。
azsphere 裝置功能選取命令可以搭配任何功能使用，但最常用於功能變數Servicing功能以啟用維護會話。 任何使用者角色都可存取 azsphere 裝置功能的選取 命令。
當您使用 fieldServicing 功能時，Azure 球體裝置和包含功能檔案的本機電腦之間會啟用通訊。 fieldServicing 功能檔案用於本機計算機和 Azure 球體裝置之間的會話，會話中的每個命令都會預先加上一則訊息，指出功能檔案正在使用。
若要結束維護會話，請 使用 azsphere 裝置功能選取 --none。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --capability-file | 字串 | 指定要選取之裝置功能組態檔的路徑和檔名。 您可以提供相對或絕對路徑。 |
| -n，--none | - | 清除任何先前選取的裝置功能設定。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.
功能顯示附加
顯示儲存在附加裝置上的功能設定。
注意
此命令會顯示使用功能檔案所設定的功能，以及部分功能，但並非全部都預設會顯示在版面上。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableFieldServicing
--------------------
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableAppDevelopment
--------------------
功能更新
將裝置功能設定套用至附加的裝置。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --capability-file | 字串 | 指定要套用之裝置功能檔案的路徑和檔名。 您可以提供相對或絕對路徑。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定執行命令的裝置。 附加多個裝置或未連接任何裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以為未連接的裝置提供裝置標識碼，也可以指定附加裝置的IP位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.
證書
管理附加裝置上的憑證。
| 操作 | 描述 |
|---|---|
| 添加 | 將憑證新增至附加裝置上的憑證存放區。 |
| 刪除 | 從附加裝置的憑證存放區刪除憑證。 |
| 清單 | 清單 附加裝置的憑證存放區中提供的憑證標識符。 |
| 顯示 | 在附加裝置的憑證存放區中顯示憑證的詳細數據。 |
| 顯示配額 | 顯示附加裝置憑證存放區中可用的可用空間。 |
憑證新增
將憑證新增至附加裝置的憑證存放區。
Root CA 和用戶端憑證必須採用 .pem 格式，才能載入 Azure 球體裝置。 您必須從適當的伺服器取得 Root CA 憑證，以及客戶端憑證和私鑰 (，並且選擇性地為您的裝置輸入私鑰) 密碼。 每個憑證都必須由EAP-TLS網路中的適當伺服器產生並簽署。 您的網路管理員或安全性小組可以提供取得憑證所需的詳細數據。 如需取得 Root CA 憑證的詳細資訊，請參閱 取得及部署 EAP-TLS 網路的憑證。
謹慎
由於用戶端和 Root CA 憑證的憑證標識碼都是全系統的，因此新增憑證 的 azsphere 命令或函數呼叫可能會覆寫先前命令或功能調用所新增的憑證，而可能導致網路連線失敗。 我們強烈建議您開發清楚的憑證更新程式，並謹慎選擇憑證標識碼。
如需詳細資訊，請參閱 憑證標識 符。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --cert-id | 字串 | 指定要新增之憑證的標識碼。 字串標識碼 (最多 16 個字元) 。 有效的字元包括 A-Z) (大寫字母、小寫字母 (a-z) 、數位 (0-9) 、底線 (_) 、句號 (.) ，以及連字元 (-) 。 此標識碼也用於 EAP-TLS 網路的 Wi-Fi 組態。 |
| --cert-type | 字串 | 指定用戶端或 Rootca 要新增的憑證類型。 |
| -p， --public-key-file | 字串 | 指定公鑰憑證 .pem 檔案的路徑。 您可以提供相對或絕對路徑。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| --private-key-file | 字串 | 指定客戶端私鑰憑證 .pem 檔案的路徑。 新增類型客戶端憑證時是必要的。 您可以提供相對或絕對路徑。 |
| -w， --private-key-password | 字串 | 指定客戶端私密的選擇性密碼。 新增加密的用戶端憑證私鑰時，需要密碼。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.
azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.
憑證刪除
從附加裝置的憑證存放區刪除憑證。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -c,--憑證 或 --cert-id [即將淘汰] |
字串 | 指定要刪除的憑證標識碼。 自 --cert-id 變數將會淘汰，並在未來版本中移除。 如需詳細資訊，請 參閱 (Azure 球體 CLI 中淘汰功能) 的重要變更。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device certificate delete --certificate certclient
憑證清單
清單 裝置的憑證存放區中提供的憑證。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device certificate list
-----------
Identifiers
===========
rootCert
-----------
憑證顯示
顯示裝置憑證存放區中個別憑證的詳細數據。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -c,--憑證 或 --cert-id [即將淘汰] |
字串 | 指定要顯示詳細數據之憑證的標識碼。 自 --cert-id 變數將會淘汰，並在未來版本中移除。 如需詳細資訊，請 參閱 (Azure 球體 CLI 中淘汰功能) 的重要變更。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
Id StartDate EndDate SubjectName IssuerName
==========================================================================================================================
certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
憑證顯示配額
顯示附加裝置憑證存放區中可用的可用空間。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------
索賠
宣告目前 Azure 球體租使用者先前未宣告的裝置。
重要
宣告裝置之前，請確定您已登入正確的 Azure 球體 租使用者。 裝置只能主張一次。 一旦提出要求，裝置就無法移至不同的租使用者。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定執行命令的裝置。 附加多個裝置或未連接任何裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以為未連接的裝置提供裝置標識碼，也可以指定附加裝置的IP位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
| --力 | 布爾 | 強制要求在目前用戶選取的 Azure 球體租使用者中要求使用裝置。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.
enable-cloud-test
透過停用應用程式開發、刪除任何現有的應用程式，以及啟用雲端載入的應用程式更新，讓附加裝置能夠測試雲端載入。
它需要將裝置連接到計算機，並且只在連接的裝置上運作。
具體來說， 啟用雲端測試：
- 拿掉附加裝置的 App功能 。
- 將裝置指派給可啟用雲端載入應用程式更新的裝置群組。
- 將裝置重新啟動。
啟用雲端測試執行的特定工作取決於是否已為此裝置指派產品和裝置群組。
如果未執行參數的 azsphere 裝置 enable-cloud-test ，裝置會置於裝置目前產品的 [功能變數測試裝置] 群組中。 這是針對每個產品自動建立的其中一個預設裝置群組，可啟用應用程式更新。 如果裝置沒有產品，或裝置中不存在 [字段測試裝置] 群組，就會傳回錯誤。
如果指定產品，裝置會置於該產品的 [字段測試裝置] 群組中。 如果此裝置群組不存在，就會傳回錯誤。
如果已指定裝置群組，則會在其中放置裝置。 如果目標裝置群組未啟用應用程式更新，就會傳回錯誤。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -p， --產品 | GUID 或名稱 | 指定目標產品。 指定此專案時，除非 --device-group 另行指定，否則裝置會移至此產品的預設 [字段測試裝置] 群組。 您可以指定 Azure 球域產品的識別碼或名稱。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
| -g，--device-group | GUID 或名稱 | 指定要將裝置移至哪一個裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 根據預設，這是產品的 [欄位測試裝置] 群組。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
範例 1. 依裝置標識碼將裝置指派給現有裝置群組
此範例會將附加的裝置指派給現有的產品和裝置群組。
azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')
範例 2. 將裝置指派給不同的裝置群組
此範例與上述範例類似，但保留裝置的現有產品。 在此 啟用雲端測試 作業會變更裝置所屬的裝置群組，並移除app的功能。 這個命令很適合用來將裝置從無法啟用應用程式更新的開發環境移至生產環境。
azsphere device enable-cloud-test --device-group "Marketing/Field Test"
範例 3. 依產品名稱指派裝置
此範例會啟用雲端載入，並依名稱將裝置指派給產品。
azsphere device enable-cloud-test --product DW100
enable-development
啟用裝置進行開發，方法是啟用裝置上的側載和偵錯，並將它指派給停用雲端應用程式更新的裝置群組。 根據預設，這是裝置產品的「開發裝置」群組，但可以指定其他裝置群組。 請勿在製造案例中使用。 如需詳細資訊，請參閱 製造連接的裝置 。
具體來說， 啟用開發：
- 下載並套用附加裝置的 app必要 功能。
- 將裝置指派給無法啟用雲端載入應用程式更新的裝置群組。
- 將裝置重新啟動。
如果您執行 azsphere 裝置啟用開發 命令，但沒有參數：
- 如果裝置還沒有產品或裝置群組，命令會下載並套用附加裝置的 App功能 ，並將裝置重新啟動。 任何現有的應用程式都會保留在裝置上，且操作系統已更新。 宣告您的裝置和快速入門以建立高階應用程式的安裝程式不受影響。
- 如果裝置已經有產品，命令會將裝置移至產品的 開發裝置群 組。 根據預設，此群組會停用應用程式更新，以確保不會覆寫側載的應用程式。
如果您使用參數執行 azsphere 裝置啟用開發 命令 --product ：
- Places產品開發裝置群組中的裝置。 如果此裝置群組不存在，就會傳回錯誤。
如果您使用參數執行 azsphere 裝置啟用開發 命令 --device-group ：
- Places 指定裝置群組中的裝置。 目標裝置群組不可啟用應用程式更新或傳回錯誤。
在某些情況下， azsphere 裝置啟用開發 報告有錯誤，並建議您宣告裝置。 如果您已經提出裝置索賠，請使用 azsphere 租使用者顯示選取， 以確保您已登入您主張裝置的租使用者。 如果沒有，請使用 azsphere 登入 以登入正確的租使用者。 當您確定已登入適當的租使用者時，請使用 azsphere 裝置索賠 裝置。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -g，--device-group | GUID 或名稱 | 指定要將裝置移至哪一個裝置群組。 如果省略，請將裝置指派給預設群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
| -r， --enable-rt-core-debugging | 布爾 | 安裝在即時核心上執行的應用程式偵錯所需的驅動程式。 此選項需要系統管理員許可權。 |
| -p， --產品 | GUID 或名稱 | 指定目標產品。 當您指定此值時，除非另行指定，否則--device-group裝置會移至此產品的預設開發裝置群組。 您可以指定 Azure 球域產品的識別碼或名稱。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')
圖像
傳回附加裝置上或已設定目標之影像的相關信息。
| 操作 | 描述 |
|---|---|
| list-installed | 提供目前安裝在附加裝置上的影像詳細數據。 |
| 清單目標 | 提供以附加裝置為目標之影像的詳細數據。 |
已安裝圖像清單
清單 附加裝置上安裝的影像。 資訊清單包含元件和圖像識別碼。
注意
長圖像名稱被截斷為31個字元。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -f，--full | 布爾 | 清單 裝置上安裝的所有軟體影像。 根據預設，只會列出應用程式影像、偵錯程式和面板設定圖像。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device image list-installed
Installed images:
--> gdbserver
--> Image type: Application
--> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
--> Image ID: dc6205bd-4478-4c9b-81ad-5e41ac23ed68
--> CrashApplicatio
--> Image type: Application
--> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
--> Image ID: cc77124e-6447-4c0f-9f99-fc0ad5ef46ef
圖像清單目標
清單 已上傳到 Azure 球體安全性服務的影像，並將在裝置更新時安裝。 如需確保 Azure 球體裝置準備好接受雲端應用程式更新的詳細資訊，請參閱 為您的裝置啟用雲端式部署。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定執行命令的裝置。 附加多個裝置或未連接任何裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以為未連接的裝置提供裝置標識碼，也可以指定附加裝置的IP位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
| -f，--full | 布爾 | 清單 Azure 球體租使用者中的所有影像。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device image list-targeted
----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
Name ComponentId ImageId ImageType RegionalDataBoundary
=======================================================================================================================================
HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications None
----------------------- ------------------------------------ ------------------------------------ -------------------------------------
清單
清單 租使用者中的所有裝置。 前 500 部裝置之後，清單會被截斷。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device list
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
您可以使用參數 --query 來自定義此命令所顯示的輸出。 如需詳細資訊，請參閱 查詢 CLI 命令輸出。
下列範例示範如何只選取 [裝置標識符] 和 [產品標識符]：
azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
提示
執行 azsphere 產品放映 -- 產品 <產品標識符> 來檢視產品名稱或 azsphere 裝置群組顯示 -- device-group <devicegroup-ID> 來檢視裝置組名。
list-attached
清單 連接到本機電腦的裝置。
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
--> Is responsive: yes
--> IP address: 192.128.48.1
--> Connection path: 21143
製造狀態
管理附加裝置的製造狀態。
| 操作 | 描述 |
|---|---|
| 顯示 | 顯示附加裝置的製造狀態。 |
| 更新 | 匯報 附加裝置的製造狀態。 |
謹慎
製造狀態變更是永久且無法復原的。
製造狀態放映
顯示附加裝置的製造狀態。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------
製造狀態更新
匯報 連接裝置的製造狀態。 如需詳細資訊，請參閱 設定裝置製造狀態。
謹慎
製造狀態變更是永久且無法復原的。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -s， --state | 製造狀態 | 指定為裝置設定的製造狀態。 可能的狀態包括 DeviceComplete 和 Module1Complete。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.
網路
提供附加裝置上網路介面狀態的相關信息。
| 操作 | 描述 |
|---|---|
| 使 | 啟用連接裝置上的網路介面。 |
| 禁用 | 停用附加裝置上的網路介面。 |
| list-firewall-rules | 清單 附加裝置的防火牆規則。 |
| list-interfaces | 清單 連接裝置的網路介面。 |
| 代理 | 管理網路 Proxy 設定。 |
| show-diagnostics | 顯示附加裝置上一或所有無線網路的網路診斷。 |
| 顯示狀態 | 顯示附加裝置的網路狀態。 |
| update-interface | 匯報裝置的網路介面設定。 |
網路啟用
啟用連接裝置上的網路介面。
注意
此命令支援乙太網路 eth0 和 wlan0 連線。 如果您設定 lo 或 azspheresvc傳回錯誤。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --介面 | 字串 | 指定要啟用的介面。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
網路停用
停用附加裝置上的網路介面。
注意
此命令支援乙太網路 eth0 和 wlan0 連線。 如果您設定 lo 或 azspheresvc傳回錯誤。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --介面 | 字串 | 指定要啟用的介面。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
網路清單-防火牆規則
清單 附加裝置的防火牆規則。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
顯示下列規則：
- 防火牆規則名稱：顯示防火牆規則組塊的名稱。
- 值為 前置、 POSTROUTING、 INPUT、 FORWARD 和 OUTPUT。
- Is Ruleset Valid： Display the status of the ruleset. 值為 True 或 False。
- 防火牆規則：顯示下列規則的值：
- 來源IP：顯示傳送電腦的IP位址。
- 來源掩碼：顯示傳送計算機的網路掩碼。
- 目的地 IP：顯示目的地電腦的 IP 位址。
- 目的地掩碼：顯示 Destomation 計算機的網路掩碼。
- UID：顯示套用至規則的使用者身分識別。 4294967295 (0xFFFFFFFF) 表示未套用 UID，因此會套用至所有人。
- 動作：顯示要採取的動作。 您可以 接受 或 捨棄值。
- 介面 IN 名稱：顯示輸入介面名稱。 例如 ，wlan0。
- 介面 OUT 名稱：顯示輸出介面名稱。 例如 ，wlan0。
- 狀態：顯示連線狀態。 這些值 都是沒有、 沒有建立的或 相關的。
- TCP 掩碼：顯示 TCP 掩碼數位陣列。 值為 fin、 syn、 rst、 psh、 ack 和 yn。
- TCP Cmp：顯示 TCP 標幟陣列。 值為 方塊、 ack、 psh、 rst、 syb 和 fin。
- TCP Inv：布爾值表示 TCP 旗標的感知器應反轉。 值為 True 或 False。
- 通訊協議：顯示防火牆規則的通訊協定。 值為 icmp、 igmp、 tcp、 udp。
- 來源埠範圍：顯示傳送流量之來源的埠範圍。 值可以是 0 到 65535 之間。
- 目的地埠範圍：顯示接收流量之目的地的埠範圍。 值可以是 0 到 65535 之間。
- 封包：顯示封包的數目。
- 位元組：顯示位元組的數目。
標幟的簡短摘要如下所列：
- URGENT：緊急指標字段顯著
- ACK：有效確認欄位
- PSH：推入函數
- RST：重設連線
- SYN：同步處理序列數位
- FIN：不再有來自發件者的數據
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network list-firewall-rules
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
Ruleset IsValid SourceIp SourceMask DestinationIp DestinationMask UID Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes TcpMask TcpCmp
=====================================================================================================================================================================================================
PREROUTING False None None None None None None None None None None None None None None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False any 0-65535 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept True tcp 0-65535 0-65535 823 394754 syn,ack syn
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True 192.168.35.1 <value> <value> <value> <value> accept azspheresvc False any 0-65535 0-65535 15 780 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
網路清單介面
清單 連接裝置的網路介面。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network list-interfaces
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses ConnectedToInternet IpAssignment HardwareAddress
========================================================================================================================
azspheresvc True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
eth0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
lo True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
wlan0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
網路 Proxy
管理網路連線的 Proxy 位址使用。 如需設定 Azure 球體裝置以透過 Proxy 伺服器連線到因特網的詳細資訊，請參閱 透過 Proxy 伺服器連線。
注意
目前僅支援 HTTP Proxy。
| 操作 | 描述 |
|---|---|
| Proxy 套用 | 在附加的裝置上設定網路 Proxy。 |
| Proxy 刪除 | 刪除附加裝置上的 Proxy 連線。 |
| Proxy 放映 | 顯示附加裝置上的 Proxy 連線。 |
Proxy 套用
在附加的裝置上設定網路 Proxy。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -a， --address | 字串 | 指定要使用的 Proxy 網路位址。 |
| -t， --驗證 | 字串 | 指定要使用的驗證類型。 允許的值： anonymous 或 basic。 如果 Proxy 需要使用者名稱和密碼，請將此設定設為 basic，否則請使用 anonymous。 |
| -r,--埠 | 整數 | 指定要使用的網路位址埠。 值必須等於或小於 65535。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| --使 | 字串 | 指定是否應該啟用 Proxy。 您必須設定或 --enable--disable。 |
| --禁用 | 字串 | 指定是否應該停用 Proxy。 您必須設定或 --enable--disable。 |
| -n， --no-proxy-addresses | 字串 | 指定裝置在 Proxy 連線時應避免的空格分隔網路位址陣列。 |
| -p， --password | 字串 | 指定僅用於基本驗證的 Proxy 驗證密碼。 長度上限：64 個字元。 |
| -u,--用戶名稱 | 字串 | 指定 Proxy 驗證的用戶名稱。 僅用於基本驗證。 長度上限：64 個字元。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
Proxy 刪除
刪除附加裝置上的 Proxy 連線。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network proxy delete
Proxy 放映
顯示附加裝置上的 Proxy 連線。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network proxy show
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
網路顯示診斷
顯示附加裝置上一或所有 Wi-Fi 網路的診斷。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -n， --network | 整數 | 指定要顯示診斷的 Wi-Fi 網路識別碼。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network show-diagnostics
------------------------- --------- ----- ------------- --------------- --------
Timestamp NetworkId Ssid ConfigState ConnectionState Error
================================================================================
2021-06-16T20:51:29+00:00 0 <value> temp-disabled disconnected WrongKey
------------------------- --------- ----- ------------- --------------- --------
網路顯示狀態
顯示附加裝置的網路狀態。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network show-status
--------------------------- --------------- -----
DeviceAuthenticationIsReady NetworkTimeSync Proxy
=================================================
True complete ready
--------------------------- --------------- -----
網路更新介面
匯報 裝置的乙太網路介面。 如需設定裝置 MAC 位址的詳細資訊，請參閱設定 乙太網路的裝置。
注意
此命令支援乙太網路 eth0 連線。 如果您設定lo， 或 wlan0， azspheresvc 就會傳回錯誤。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --hardware-address | 字串 | 指定下列其中一種格式為裝置設定的硬體位址：或 AA:BB:33:DD:EE:FFaa:bb:33:dd:ee:ff。 |
| --介面 或 --interface-name [即將淘汰] |
字串 | 指定要設定的介面名稱。 執行 azsphere 裝置網路清單介面 ，以檢視附加裝置的網路介面詳細數據。 自 --interface-name 變數將會淘汰，並在未來版本中移除。 如需詳細資訊，請 參閱 (Azure 球體 CLI 中淘汰功能) 的重要變更。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10
恢復
取代裝置上的系統軟體。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 系統預設會使用目前連接的裝置。 指定裝置的識別碼、IP 位址或本機連線標識碼。 |
| -c， --功能 | 字串 | 指定要在復原期間套用至裝置的裝置功能映像。 |
| -i， --影像 | 字串 | 指定包含要寫入裝置之圖像套件的資料夾路徑。 根據預設，除非此標幟提供替代路徑，否則復原會使用 SDK 中的影像。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
範例 1：
azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
範例 2：
azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
rescan-attached
透過開啟所有 FTDI 埠來重新傳回連接的裝置，並顯示附加裝置的總計數。 疑難解答 Windows 上的裝置連線問題時，請使用此命令。 此命令只會在 Windows 上執行。
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device rescan-attached
-----------
Count
===========
2
-----------
重新啟動
重新啟動連接的裝置。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device restart
Restarting device.
Device restarted successfully.
顯示
顯示 Azure 球體租使用者中附加裝置的詳細數據。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定執行命令的裝置。 附加多個裝置或未連接任何裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以為未連接的裝置提供裝置標識碼，也可以指定附加裝置的IP位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device show
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
您可以使用參數 --query 來自定義此命令所顯示的輸出。 如需詳細資訊，請參閱 查詢 CLI 命令輸出。
下列範例示範如何只選取 [裝置標識符] 和 [產品標識符]：
azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
顯示附加
顯示裝置本身所附加裝置的相關信息。 這些詳細數據與 Azure 球體安全性服務針對裝置儲存的詳細數據不同。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143
show-deployment-status
顯示裝置應用程式和作業系統更新的部署狀態。
使用此命令來找出您的裝置執行的 Azure 球體 OS 版本，或目前部署更新是否已完成。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.
在此範例中， <version-number> 代表目前的操作系統版本。
show-count
顯示目前租使用者中的裝置數量。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device show-count
------
Result
======
2
------
show-os-version
在附加的裝置上顯示目前的操作系統版本。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>
在此範例中， <version-number> 代表目前的操作系統版本。
側載
管理裝置上的應用程式。
一旦裝置處於製造狀態 [DeviceComplete]，部分側載選項就需要額外的功能。 FieldServicing 功能可讓您部署和刪除臨時生產簽署影像，並部署永久的生產簽署影像。 app其他功能可讓您部署和刪除已簽署生產狀態的影像和 SDK 簽名的影像。
| 操作 | 描述 |
|---|---|
| 刪除 | 從裝置中刪除目前的應用程式。 |
| 部署 | 將應用程式載入裝置。 |
| set-deployment-timeout | 將部署逾時期間設定為秒數。 |
| show-deployment-timeout | 以秒為內顯示部署逾時期間。 |
請注意，已將參數移至 start、 stop、 show-status和 show-quota 已移至 azsphere 裝置 App 命令。
側載刪除
從裝置刪除應用程式。
只有已設定 app的裝置 功能時，才能使用此命令。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --元件-id | Guid | 指定要從裝置刪除的應用程式識別碼。 如果省略，則會刪除所有應用程式。 |
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.
側載部署
將應用程式載入附加的裝置並啟動應用程式。
如果應用程式指令清單要求裝置上已有應用程式使用的資源，則此命令會失敗。 在此情況下，使用 azsphere 裝置側載刪除 來刪除現有的應用程式，然後再次嘗試側載。 azsphere 裝置側載刪除命令會刪除高階應用程式和實時應用程式。 若要刪除一個應用程式並保留另一個應用程式，請指定要刪除之應用程式的元件標識碼。
相同的命令也用於部署高階應用程式和支援即時的應用程式。
注意
安裝使用介面設備的新應用程式且符合下列條件時，會觸發裝置重新啟動：
- 裝置的製造狀態設定為 DeviceComplete。
- app其他功能不在裝置上。 如需詳細資訊，請參閱 周邊設定鎖定。
如果裝置重新啟動，請等到重新啟動完成，裝置變成響應靈敏。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -p， --image-package | 字串 | 指定要載入在裝置上的影像套件路徑和檔名。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -m， --手動啟動 | 布爾 | 指定載入後不要自動啟動應用程式。 |
| --力 | 布爾 | 強制部署可能不再支援的 Beta API 影像。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.
側載 set-deployment-timeout
將裝置上側載影像的部署逾時值設定為秒數。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -v， --value | 整數 | 指定側載命令逾時之前的秒內工期。值必須是正整數。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device sideload set-deployment-timeout --value 60
------------------
Deployment timeout
==================
60
------------------
側載 show-deployment-timeout
在裝置上側載影像時，會在幾秒鐘內顯示目前的部署逾時值。
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device sideload show-deployment-timeout
------------------
Deployment timeout
==================
60
------------------
更新
將裝置移至 Azure 球體租使用者中的其他裝置群組。
除了您在產品中建立的裝置群組，當產品建立時，會新增五個預設裝置群組：
- 開發：僅接受系統軟體更新。 不接受應用程式更新。
- 欄位測試：接受 Azure 球體安全性服務的所有更新。
- 生產：接受 Azure 球體安全性服務的所有更新。
- 生產OS評估：接受 Azure 球體安全性服務的所有更新。
- 欄位測試 OS 評估：接受 Azure 球體安全性服務的所有更新。
如需部署中涉及之基本元素的詳細資訊，請參閱 部署基本概念。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -g，--device-group | GUID 或名稱 | 指定要在其中行動裝置的裝置群組。 您可以指定裝置群組識別碼或裝置組名。 若要使用裝置群組名稱，您必須以格式同時提供產品名稱和裝置組名 <product-name/device-group-name> 。 |
| -d， --device | 字串 | 指定執行命令的裝置。 附加多個裝置或未連接任何裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以為未連接的裝置提供裝置標識碼，也可以指定附加裝置的IP位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device update --device-group AW100/Marketing
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
==============================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
427D205E46A166B7E41135EB968
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
您可以使用參數 --query 來自定義此命令所顯示的輸出。 如需詳細資訊，請參閱 查詢 CLI 命令輸出。
下列範例示範如何只選取 [裝置標識符] 和 [產品標識符]：
azsphere device update --device-group AW100/Marketing --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
無線
管理附加裝置的 Wi-Fi 設定。
若要在 Wi-Fi 網路上使用裝置，您必須新增網路相關信息，並在裝置上啟用網路。 雖然您可以在 SSID 中輸入非 ASCII 字元， 但 azsphere 無法正確顯示。
如果您的應用程式使用 Wi-Fi設定 API，您也必須在應用程式的 app_manifest.json 檔案中包含 WifiConfig 功能。
| 操作 | 描述 |
|---|---|
| 添加 | 將無線網路的詳細數據新增至裝置。 |
| 禁用 | 停用裝置上的無線網路。 |
| 使 | 啟用裝置上的無線網路。 |
| 忘記 | 從裝置移除無線網路的詳細數據。 |
| 清單 | 清單 裝置目前的 Wi-Fi 設定。 |
| 重載設定 | 重載裝置 Wi-Fi 設定。 |
| 掃描 | 掃描可用的網路。 |
| 顯示 | 顯示 Wi-Fi 設定的詳細數據。 |
| 顯示狀態 | 顯示無線介面的狀態。 |
wifi 新增
將 Wi-Fi 網路的詳細數據新增至附加的裝置。
裝置可以有多個 Wi-Fi 連線。 雖然您可以在 SSID 中輸入非 ASCII 字元， 但 azsphere 無法正確顯示。
您可以包含 --targeted-scan 可連線至隱藏 SSID 的參數。 如需詳細資訊，請參閱 將 Azure 球體連線到 Wi-Fi。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -s，--ssid | 字串 | 指定網路的 SSID。 網路 SSID 會區分大小寫。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --client-cert-id | 字串 | [EAP-TLS]指定標識子 (最多 16 個字元，) 可識別包含公用和私鑰) 的用戶端憑證 (。 需要設定 EAP-TLS 網路。 |
| --client-id <user@domain> | 字串 | [EAP-TLS]指定網路的RADIUS伺服器可辨識驗證的識別碼。 某些 EAP-TLS 網路需要。 |
| --config-name | 字串 | 指定最多 16 個字元 (字串，) 指定網路設定的名稱。 |
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
| --root-ca-cert-id | 字串 | [EAP-tLS]指定標識子 (最多 16 個字元) 可識別裝置驗證伺服器之 EAP-TLS 網路的伺服器根 CA 憑證。 |
| --targeted-scan | 布爾 | 即使網路未廣播或因網路囯塞而隱藏，也嘗試連線到網路。 |
| -p， --psk | 字串 | 指定新網路的 WPA/WPA2 金鑰。 省略將 SSID 新增為開放式網路。 如果您的按鍵含有音量符號 (&) ，請以引號括住該按鍵。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
1 MyNetwork enabled unknown psk False
----- -------- ------------------ --------------- ------------- ------------
如果網路 SSID 或機碼有內嵌空格或擴充器，請以單引弧括住 SSID 或按鍵。 如果 SSID 或按鍵包含引號，請使用反斜杠來避開引號。 如果反斜杠屬於值，就不需要逸出。 如需詳細資訊，請參閱 引號和逸出字元。 例如：
azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
wifi 停用
在附加的裝置上停用 Wi-Fi 網路。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --id | 整數 | 指定要停用的網路識別碼。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork disabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
啟用 wifi
在連接的裝置上啟用 Wi-Fi 網路。
若要在範圍內從一個網路變更為另一個網路，請先停用目前連線的網路，再啟用新網路。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --id | 整數 | 指定要啟用的網路識別碼。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi enable --id 0
Successfully enabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork enabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
wifi 忘記
從附加的裝置移除 Wi-Fi 網路的詳細數據。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --id | 整數 | 指定要刪除的網路識別碼。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi forget --id 0
Successfully forgotten network.
wifi 清單
清單 附加裝置目前的 Wi-Fi 設定。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi list
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork1 enabled connected psk False
----- --------- ------------------ --------------- ------------- ------------
1 MyNetwork2 enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
2 MyNetwork3 enabled disconnected eaptls False
----- --------- ------------------ --------------- ------------- ------------
wifi 重載設定
在連接的裝置上重載 Wi-Fi 網路設定。 新增或移除 azsphere 裝置憑證 (憑證) 後，請使用此命令，以確保 EAP-TLS 網路使用憑證存放區的最新內容。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.
wifi 掃描
掃描附加裝置可見的可用 Wi-Fi 網路。 此命令最多會傳回 64 個 Wi-Fi 網路，但顯示的 Wi-Fi 網路數目可能受限於環境因素，例如範圍內的存取點密度。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID SecurityState BSSID SignalLevel Frequency
=======================================================================
MyNetwork0 psk <value> -66 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1 psk <value> -75 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2 psk <value> -86 2412
----------------- ------------- ----------------- ----------- ---------
wifi 放映
顯示附加裝置上 Wi-Fi 網路的詳細數據。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -i， --id | 整數 | 指定要顯示的網路設定識別碼。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi show --id 0
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
wifi 顯示狀態
顯示連接裝置上 Wi-Fi 介面的狀態。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機線上標識碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配Linux上的命令使用，就會傳回錯誤。 |
全域參數
下列全域參數適用於 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報告時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 數據表) ，以及 yaml。 根據預設，CLI 輸出 。table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印作業期間在 Azure 球體中建立之資源的相關信息及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere device wifi show-status
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
SSID ConfigurationState ConnectionState SecurityState Frequency Mode KeyManagement WpaState IpAddress MacAddress
================================================================================================================================
<value> enabled connected psk 2412 station WPA2-PSK COMPLETED <value> <value>
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------