共用方式為

az sphere device wifi

  • 參考

注意

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

管理連結裝置的Wi-Fi組態。

命令

名稱 Description 類型 狀態
az sphere device wifi add

在連結的裝置上新增Wi-Fi網路。

 副檔名 GA
az sphere device wifi disable

停用連結裝置上的Wi-Fi連線。

 副檔名 GA
az sphere device wifi enable

在連接的裝置上啟用Wi-Fi網路。

 副檔名 GA
az sphere device wifi forget

忘記連結裝置上的Wi-Fi網路。

 副檔名 GA
az sphere device wifi list

列出連結裝置目前的Wi-Fi組態。

 副檔名 GA
az sphere device wifi reload-config

在連接的裝置上重載Wi-Fi網路設定。 新增或移除憑證之後，請使用此命令（azsphere device certificate），以確保 EAP-TLS 網路使用證書存儲的最新內容。

 副檔名 GA
az sphere device wifi scan

掃描連結裝置可看見的可用Wi-Fi網路。

 副檔名 GA
az sphere device wifi show

在連結的裝置上顯示Wi-Fi網路的詳細數據。

 副檔名 GA
az sphere device wifi show-status

顯示連接裝置上無線介面的狀態。

 副檔名 GA

az sphere device wifi add

在連結的裝置上新增Wi-Fi網路。

az sphere device wifi add --ssid
                          [--client-cert-id]
                          [--client-id]
                          [--config-name]
                          [--device]
                          [--psk]
                          [--root-ca-cert-id]
                          [--targeted-scan]

範例

新增開啟的Wi-Fi網路

az sphere device wifi add --ssid

新增 WPA/WPA2 PSK 保護的Wi-Fi 網路

az sphere device wifi add --ssid NETWORK1 --psk EXAMPLEPSK

新增 EAP-TLS Wi-Fi 網路

az sphere device wifi add --ssid myEapTlsSsid --client-cert-id myClientCert --client-id user@domain.com --root-ca-cert-id myRootCA --config-name Network1

必要參數

--ssid -s

要連線之網路的 SSID。

選擇性參數

--client-cert-id

[EAP-TLS] - 識別用戶端憑證的字串值（最多 16 個字元）（包含公開和私鑰）。 設定 EAP-TLS 網路的必要專案。

--client-id

user@domain [EAP-TLS] 識別符，由此網路的RADIUS伺服器辨識以進行驗證。 某些 EAP-TLS 網路的必要專案。

--config-name

指定此網路組態名稱的字串值（最多 16 個字元）。

--device -d

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

值來源: az sphere device list-attached
--psk -p

新網路的 WPA/WPA2 PSK。 如果連線到開啟的網路，請勿設定此設定。

--root-ca-cert-id

[EAP-TLS] - 字串值（最多 16 個字元），可識別裝置驗證伺服器之 EAP-TLS 網络的根 CA 憑證。

--targeted-scan

即使未公告，仍嘗試連線到 SSID。

預設值: 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 wifi disable

停用連結裝置上的Wi-Fi連線。

az sphere device wifi disable --id
                              [--device]

範例

停用已設定的Wi-Fi網路

az sphere device wifi disable --id 1

必要參數

--id -i

要停用的網路標識碼。

選擇性參數

--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 wifi enable

在連接的裝置上啟用Wi-Fi網路。

az sphere device wifi enable --id
                             [--device]

範例

啟用已設定的Wi-Fi網路

az sphere device wifi enable --id 1

必要參數

--id -i

要啟用的網路識別碼。

選擇性參數

--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 wifi forget

忘記連結裝置上的Wi-Fi網路。

az sphere device wifi forget --id
                             [--device]

範例

忘記設定的Wi-Fi網路

az sphere device wifi forget --id 1

必要參數

--id -i

要忘記的網路標識碼。

選擇性參數

--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 wifi list

列出連結裝置目前的Wi-Fi組態。

az sphere device wifi list [--device]

範例

列出已設定的Wi-Fi網路

az sphere device wifi list

選擇性參數

--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 wifi reload-config

在連接的裝置上重載Wi-Fi網路設定。 新增或移除憑證之後，請使用此命令（azsphere device certificate），以確保 EAP-TLS 網路使用證書存儲的最新內容。

az sphere device wifi reload-config [--device]

範例

重載設定的Wi-Fi網路

az sphere device wifi reload-config

選擇性參數

--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 wifi scan

掃描連結裝置可看見的可用Wi-Fi網路。

az sphere device wifi scan [--device]

範例

掃描Wi-Fi網路

az sphere device wifi scan

選擇性參數

--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 wifi show

在連結的裝置上顯示Wi-Fi網路的詳細數據。

az sphere device wifi show --id
                           [--device]

範例

顯示已設定Wi-Fi網路的詳細數據

az sphere device wifi show

必要參數

--id -i

要顯示詳細數據的網路識別碼。

選擇性參數

--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 wifi show-status

顯示連接裝置上無線介面的狀態。

az sphere device wifi show-status [--device]

範例

顯示已設定Wi-Fi網路的狀態

az sphere device wifi show-status

選擇性參數

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