다음을 통해 공유

Azure Sphere CLI 개요

  • 아티클

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

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

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를 참조하세요.

중요

  • 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 Security Service에 로그인해야 합니다.

  • ca-certificate
  • device-group
  • get-support-data
  • 이미지
  • 로그인
  • Logout
  • 제품
  • register-user
  • 역할
  • show-user
  • 테 넌 트

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

azsphere device command 코멘트
기능 디바이스 기능 다운로드를 위해 Azure Sphere Security Service 필요
주장
enable-cloud-test
enable-development
이미지
목록
복구 인터넷 연결이 필요하지만 Azure Sphere Security Service에 로그인하지 않음
표시
show-count
show-deployment-상태
show-os-version 인터넷 연결이 필요하지만 Azure Sphere Security Service에 로그인하지 않음
업데이트

디바이스 기능 종속 명령

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

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

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