다음을 통해 공유

Azure Sphere CLI 개요

  • 아티클

Important

Azure Sphere(레거시) 설명서입니다. Azure Sphere(레거시)는 2027년 9월 27일에 사용 중지되며 사용자는 이 시간까지 Azure Sphere(통합)로 마이그레이션해야 합니다. TOC 위에 있는 버전 선택기를 사용하여 Azure Sphere(통합) 설명서를 볼 수 있습니다.

Azure Sphere CLI는 Azure Sphere 리소스를 관리하는 데 사용되는 명령 집합입니다.

다음 명령을 사용할 수 있습니다.

참고 항목

이제 register-user 명령은 더 이상 사용되지 않습니다.

Azure Sphere CLI 및 Azure Sphere 클래식 CLI

Azure Sphere CLI는 Windows 및 Linux 모두에서 기존 CLI와 함께 설치되므로 두 인터페이스에 모두 액세스할 수 있습니다. Azure Sphere 클래식 CLI는 항상 작동합니다.

Azure Sphere CLI를 사용하려면 다음을 수행합니다.

  • Windows에서 PowerShell 또는 표준 Windows 명령 프롬프트를 사용합니다.
  • Linux에서 명령 셸을 사용합니다. SDK 설치 중에 Azure Sphere CLI를 기본값으로 설정하는 경우 azsphere 명령을 지정하고 , Azure Sphere 클래식 CLI를 기본값으로 설정한 경우 azsphere_v2 명령을 지정합니다.

Azure Sphere CLI에서 지원하는 기능 및 명령에 대한 자세한 내용은 Azure Sphere CLI를 참조하세요.

Important

  • Windows에서 사용 중지된 Azure Sphere 클래식 개발자 명령 프롬프트 바로 가기는 Azure Sphere 클래식 CLI에서만 사용할 수 있습니다.

명령줄 형식

azsphere 명령줄의 형식은 다음과 같습니다.

azsphere [command] [subcommand] operation [parameters]

일반적으로 명령 및 하위 명령은 명사이고 작업은 동사이므로 해당 조합은 작업과 작업의 개체를 모두 식별합니다. 대부분의 명령 및 작업에는 전체 이름과 약어가 있습니다. 예를 들어 디바이스 명령은 약어 d입니다.

대부분의 매개 변수 에는 긴 이름과 약어가 있습니다. 명령줄에서 하이픈이 두 개 있는 긴 이름과 단일 하이픈이 있는 약어를 소개합니다. 예를 들어 다음 두 명령은 동일합니다.

azsphere device wifi add --ssid MyNetwork --psk mynetworkkey

azsphere device wifi add -s MyNetwork -p mynetworkkey

일부 명령은 단일 매개 변수에 대해 여러 값을 허용합니다. Azure Sphere CLI에서는 단일 매개 변수와 공백으로 구분된 값 목록을 제공할 수 있으며 Azure Sphere 클래식 CLI에서는 값 목록이 쉼표로 구분됩니다. 예시:

azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

따옴표 및 이스케이프 문자

Azure Sphere CLI 명령을 사용하는 경우 셸에서 따옴표를 사용하고 문자를 이스케이프하는 방법을 알고 있어야 합니다. 다른 셸에서 사용되는 스크립트를 지원하는 경우 어떻게 다른지 이해해야 합니다.

예시:

클라우드 종속 명령

다음 azsphere 명령에는 클라우드 연결이 필요하고 Azure Sphere 보안 서비스에 로그인해야 합니다.

  • ca-certificate
  • device-group
  • get-support-data
  • 이미지
  • login
  • logout
  • product
  • 역할(role)
  • show-user
  • 테넌트

또한 다음 azsphere device 명령에도 클라우드 연결이 필요합니다.

azsphere device command 설명
capability 디바이스 기능 다운로드를 위해 Azure Sphere Security Service 필요
주장
enable-cloud-test
enable-development
image
목록
recover 인터넷 연결이 필요하지만 Azure Sphere Security Service에 로그인하지 않아도 됨
show
show-count
show-deployment-status
show-os-version 인터넷 연결이 필요하지만 Azure Sphere Security Service에 로그인하지 않아도 됨
업데이트

디바이스 기능 종속 명령

다음 azsphere 디바이스 명령을 사용하려면 디바이스 기능을 제조 상태 DeviceComplete의 디바이스에 사용해야 합니다.

연산 설명
앱 연결된 디바이스에서 애플리케이션을 관리합니다.
capability 디바이스 기능 구성을 관리합니다. 기능 업데이트에 필요합니다.
인증서(certificate) 디바이스 인증서 저장소를 관리합니다.
이미지 디바이스 이미지를 관리합니다.
manufacturing-state 연결된 디바이스의 제조 상태를 관리합니다. 제조 상태 업데이트에 필요합니다.
restart 연결된 디바이스를 다시 시작합니다.
show-deployment-status 연결된 디바이스에서 운영 체제 및 애플리케이션의 배포 상태를 표시합니다.
show-os-version 연결된 디바이스에 운영 체제 버전을 표시합니다.
sideload 연결된 디바이스에서 애플리케이션을 배포하고 관리합니다. 테스트용 로드 배포 및 테스트용 로드 삭제에 필요합니다.
wifi 연결된 디바이스의 Wi-Fi 구성을 관리합니다.

기능 없이 이러한 명령을 실행하려고 하면 디바이스에 대한 기능 파일을 다운로드하고 선택하는 데 사용 azsphere device capability 하거나 실행 azsphere device enable-development 하라는 오류 메시지가 표시됩니다.