Azure Sphere CLI 개요
Azure Sphere CLI는 Azure Sphere 리소스를 관리하는 데 사용되는 명령 집합입니다.
다음 명령을 사용할 수 있습니다.
- ca-certificate
- 장치
- device-group
- 피드백
- get-support-data
- 하드웨어 정의
- 이미지
- image-package
- 대화형 (명령은 미리 보기 상태임)
- 로그인
- Logout
- 제품
- register-user
- 역할
- show-user
- show-version
- 설정
- 테 넌 트
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 명령을 사용하는 경우 셸에서 따옴표를 사용하고 문자를 이스케이프하는 방법을 알고 있어야 합니다. 다른 셸에서 사용되는 스크립트를 지원하는 경우 어떻게 다른지 이해해야 합니다.
예를 들어:
- Bash: 따옴표
- PowerShell: 따옴표 규칙 정보
- Windows 명령 프롬프트: 방법: Windows 명령줄에서 문자, 구분 기호 및 따옴표 이스케이프
클라우드 종속 명령
다음 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
하라는 오류 메시지가 표시됩니다.