az sphere device

Azure Sphere 디바이스를 관리합니다.

작업	설명
az sphere device rescan-attached	연결된 디바이스 수를 표시합니다.
az sphere device list-attached	연결된 모든 디바이스를 나열합니다.
az sphere device show-attached	연결된 디바이스의 세부 정보를 표시합니다.
az sphere device list	카탈로그, 제품 또는 디바이스 그룹의 모든 디바이스를 나열합니다.
az sphere device show-count	카탈로그, 제품 또는 디바이스 그룹의 디바이스 수를 표시합니다.
az sphere device show	리소스 그룹 및 카탈로그에 기존 디바이스의 세부 정보를 표시합니다.
az sphere device assign	리소스 그룹 및 카탈로그의 디바이스 그룹에 디바이스를 할당합니다.
az sphere device unassign	리소스 그룹 및 카탈로그의 디바이스 그룹에서 디바이스를 할당 취소합니다.
az sphere device restart	연결된 디바이스를 다시 시작합니다.
az sphere device claim	리소스 그룹 및 카탈로그에서 디바이스를 클레임합니다.
az sphere device recover	복구 모드를 사용하여 연결된 디바이스에 새 펌웨어를 로드합니다.
az sphere device show-os-version	연결된 디바이스에 운영 체제 버전을 표시합니다.
az sphere device show-deployment-상태	디바이스에서 운영 체제의 배포 상태 표시합니다.
az sphere device enable-development	"연결된 디바이스에서 사이드로드 및 디버깅을 사용하도록 설정하고 클라우드에서 애플리케이션 업데이트를 사용하지 않도록 설정하는 디바이스 그룹에 할당하여 디바이스를 개발하도록 설정합니다. 기본적으로 디바이스 제품의 개발 디바이스 그룹이 되지만 다른 디바이스 그룹을 지정할 수 있습니다. 제조 시나리오에서는 사용할 수 없음
az sphere device enable-cloud-test	"연결된 디바이스에서 개발 및 디버깅을 사용하지 않도록 설정하고 클라우드에서 애플리케이션 업데이트를 사용하도록 설정하는 디바이스 그룹에 할당하여 클라우드 로드를 테스트하기 위해 디바이스를 사용하도록 설정합니다. 기본적으로 디바이스 제품의 필드 테스트 디바이스 그룹이 되지만 다른 디바이스 그룹을 지정할 수 있습니다. 제조 시나리오에서는 사용할 수 없음

명령을

az sphere device rescan-attached

연결된 디바이스 수를 표시합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

예제

연결된 디바이스 수를 표시합니다.

az sphere device rescan-attached

az sphere device list-attached

연결된 모든 디바이스를 나열합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

예제

연결된 모든 디바이스를 나열합니다.

az sphere device list-attached

az sphere device show-attached

연결된 디바이스의 세부 정보를 표시합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list

예제

연결된 디바이스의 세부 정보를 표시합니다.

az sphere device show-attached

지정된 디바이스의 세부 정보를 표시합니다.

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

az sphere device list

카탈로그, 제품 또는 디바이스 그룹의 모든 디바이스를 나열합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--product -p	제품 이름입니다. 값: az sphere product list
--device-group -dg	표시할 디바이스 그룹입니다. 값: az sphere device

예제

리소스 그룹 및 카탈로그의 모든 디바이스를 나열합니다.

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

리소스 그룹, 카탈로그 및 제품의 모든 디바이스를 나열합니다.

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

리소스 그룹, 카탈로그, 제품 및 디바이스 그룹의 모든 디바이스를 나열합니다.

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

az sphere device show-count

카탈로그, 제품 또는 디바이스 그룹의 디바이스 수를 표시합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--product -p	제품 이름입니다. 값: az sphere product list
--device-group -dg	표시할 디바이스 그룹입니다. 값: az sphere device

예제

리소스 그룹 및 카탈로그의 디바이스 수를 표시합니다.

az sphere device show-count --resource-group MyResourceGroup --catalog MyCatalog

리소스 그룹, 카탈로그 및 제품의 디바이스 수를 표시합니다.

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

리소스 그룹, 카탈로그, 제품 및 디바이스 그룹의 디바이스 수를 표시합니다.

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

az sphere device show

리소스 그룹 및 카탈로그에 기존 디바이스의 세부 정보를 표시합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list

예제

리소스 그룹, 카탈로그 이름 및 디바이스 ID를 사용하여 디바이스의 세부 정보를 표시합니다.

az sphere device show --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device assign

리소스 그룹 및 카탈로그의 디바이스 그룹에 디바이스를 할당합니다.

필수 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list
--target-product	대상 제품의 이름입니다. 값: az sphere product list
--target-device-group	대상 디바이스 그룹의 이름입니다. 값: az sphere device
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

예제

리소스 그룹, 카탈로그 이름, 대상 제품 이름, 대상 디바이스 그룹 이름 및 디바이스 ID를 사용하여 디바이스를 할당합니다.

az sphere device assign --resource-group MyResourceGroup --catalog MyCatalog --target-product MyProduct --target-device-group MyCurrentDeviceGroup --device <DeviceIdValue>

az sphere device unassign

리소스 그룹 및 카탈로그의 디바이스 그룹에서 디바이스를 할당 취소합니다.

필수 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

예제

리소스 그룹, 카탈로그 이름 및 디바이스 ID를 사용하여 디바이스를 할당 취소합니다.

az sphere device unassign --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device restart

연결된 디바이스를 다시 시작합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list

예제

연결된 디바이스를 다시 시작합니다.

az sphere device restart

지정된 디바이스를 다시 시작합니다.

az sphere device restart --device <DeviceIdValue>

az sphere device claim

리소스 그룹 및 카탈로그에서 디바이스를 클레임합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list
--product -p	제품 이름입니다. 값: az sphere product list
--device-group -dg	표시할 디바이스 그룹입니다. 값: az sphere device

예제

리소스 그룹, 카탈로그 이름 및 디바이스 ID를 사용하여 디바이스를 클레임합니다.

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

리소스 그룹, 카탈로그 이름, 제품 이름, 디바이스 그룹 이름 및 디바이스 ID를 사용하여 디바이스를 클레임합니다.

az sphere device claim --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device recover

복구 모드를 사용하여 연결된 디바이스에 새 펌웨어를 로드합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list
--기능	복구하는 동안 디바이스에 적용할 디바이스 기능 이미지의 파일 이름입니다. (경로).
--이미지	디바이스에 쓸 이미지 패키지가 포함된 폴더입니다. 지정하지 않으면 최신 OS 이미지가 다운로드되어 사용됩니다. (경로).

예제

연결된 디바이스를 복구합니다.

az sphere device recover

특정 기능 및 이미지를 사용하여 연결된 디바이스를 복구합니다.

az sphere device recover --capability myCapability.cap --images myImagesFolder

az sphere device show-os-version

연결된 디바이스에 운영 체제 버전을 표시합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list

예제

연결된 디바이스에 운영 체제 버전을 표시합니다.

az sphere device show-os-version

지정된 디바이스에서 작업 시스템 버전을 표시합니다.

az sphere device show-os-version --device <DeviceIdValue>

az sphere device show-deployment-상태

디바이스에서 운영 체제의 배포 상태 표시합니다.

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list

예제

리소스 그룹, 카탈로그 이름 및 디바이스 ID를 사용하여 운영 시스템의 배포 상태 표시합니다.

az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device enable-development

"연결된 디바이스에서 사이드로드 및 디버깅을 사용하도록 설정하고 클라우드에서 애플리케이션 업데이트를 사용하지 않도록 설정하는 디바이스 그룹에 할당하여 디바이스를 개발하도록 설정합니다. 기본적으로 디바이스 제품의 개발 디바이스 그룹이 되지만 다른 디바이스 그룹을 지정할 수 있습니다. 제조 시나리오에서는 사용할 수 없음

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list
--enable-rt-core-debugging -r	실시간 코어에서 실행되는 애플리케이션을 디버그하는 데 필요한 드라이버를 설치합니다. 관리자 권한이 필요합니다.
--product -p	제품 이름입니다. 값: az sphere product list
--device-group -dg	표시할 디바이스 그룹입니다. 값: az sphere device

예제

리소스 그룹, 카탈로그 이름, 디바이스 ID 및 기본 개발 디바이스 그룹을 사용하여 사이드로드 및 디버깅을 사용하도록 설정하여 디바이스를 개발하도록 설정합니다.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

리소스 그룹, 카탈로그 이름, 제품 이름, 디바이스 그룹 이름 및 디바이스 ID를 사용하여 사이드로드 및 디버깅을 사용하도록 설정하여 디바이스를 개발하도록 설정합니다.

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>

az sphere device enable-cloud-test

"연결된 디바이스에서 개발 및 디버깅을 사용하지 않도록 설정하고 클라우드에서 애플리케이션 업데이트를 사용하도록 설정하는 디바이스 그룹에 할당하여 클라우드 로드를 테스트하기 위해 디바이스를 사용하도록 설정합니다. 기본적으로 디바이스 제품의 필드 테스트 디바이스 그룹이 되지만 다른 디바이스 그룹을 지정할 수 있습니다. 제조 시나리오에서는 사용할 수 없음

필수 매개 변수

매개 변수	설명
--catalog -c	이 작업을 수행할 Azure Sphere 카탈로그입니다. Azure Sphere 카탈로그 이름을 지정합니다. 를 사용하여 기본 Azure Sphere 카탈로그를 az config set defaults.sphere.catalog=<name>구성할 수 있습니다. 값: az sphere catalog list.
--resource-group -r	Azure 리소스 그룹의 이름입니다. 를 사용하여 az config set defaults.group=<name>기본 그룹을 구성할 수 있습니다. 값: az group list.

선택적 매개 변수

매개 변수	설명
--device -d	여러 디바이스가 연결된 경우 명령을 실행할 디바이스입니다. 연결된 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. 값: az sphere device list
--product -p	제품 이름입니다. 값: az sphere product list
--device-group -dg	표시할 디바이스 그룹입니다. 값: az sphere device

예제

리소스 그룹, 카탈로그 이름, 디바이스 ID 및 기본 필드 테스트 디바이스 그룹을 사용하여 클라우드를 테스트하기 위해 디바이스를 사용하도록 설정합니다.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

리소스 그룹, 카탈로그 이름, 제품 이름, 디바이스 그룹 이름 및 디바이스 ID를 사용하여 클라우드를 테스트하기 위해 디바이스를 사용하도록 설정합니다.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --device <DeviceIdValue>