다음을 통해 공유

클래식 CLI에서 Azure Sphere CLI로 마이그레이션

  • 아티클

여전히 Azure Sphere 클래식 CLI를 사용하는 경우 새 Azure Sphere CLI로 마이그레이션하는 것이 좋습니다. 현재 두 버전의 CLI를 함께 설치하고 사용할 수 있지만 클래식 CLI는 더 이상 업데이트되거나 유지 관리되지 않으며 이후 날짜(2022년 말 이전이 아님)에 SDK에서 제거됩니다. 이러한 차이점을 숙지하고 중단을 방지하기 위해 2022년 말 이전에 프로세스 및 스크립트를 마이그레이션하는 것이 좋습니다.

최신 SDK로 업데이트하려면 Linux에 Azure Sphere SDK 설치 또는 Windows용 Azure Sphere SDK 설치를 참조하세요.

Windows에서 Azure Sphere CLI를 사용하려면 PowerShell 또는 표준 Windows 명령 프롬프트를 사용합니다. Linux의 경우 모든 명령 셸을 사용합니다. 자세한 내용은 Azure Sphere CLI 실행을 참조하세요.

Windows에서는 사용 중지된 사용자 지정 Azure Sphere 클래식 개발자 명령 프롬프트(Azure Sphere의 시작 메뉴에서 바로 가기로 사용 가능)는 Azure Sphere 클래식 CLI에서만 사용할 수 있습니다. 자세한 내용은 Azure Sphere 클래식 CLI 실행을 참조하세요.

주요 차이점

  • Azure Sphere 클래식 CLI에서는 여러 매개 변수를 사용하여 각 개체 형식을 식별할 수 있습니다. Azure Sphere CLI에서 단일 매개 변수를 사용하여 각 개체 형식을 식별합니다. 즉, 이름 또는 ID를 사용하여 매개 변수 값을 지정할 수 있습니다. 이는 , , --tenant--product및 --device-group 매개 변수에 --device대해 구현되었습니다.

    개체 유형 Azure Sphere CLI Azure Sphere 클래식 CLI(사용 중지)
    장치 --device --deviceid, --deviceip, 또는 --devicelocation
    디바이스 그룹 --device-group --devicegroupid 또는 --devicegroupname
    제품 --product --productid 또는 --productname
    테 넌 트 --tenant --tenantid

  • 명령에 대한 짧은 형식은 클래식 버전에서 지원됩니다. Azure Sphere CLI에서는 탭 완성 또는 대화형 기능을 사용하여 사용 가능한 명령 목록을 보는 것이 좋습니다. 예를 들어 클래식 CLI에서는 또는 azsphere dev edv 명령을 사용할 azsphere device enable-development 수 있지만 새 Azure Sphere CLI에서는 자동 완성을 사용하여 명령을 빠르게 입력 azsphere device enable-development 할 수 있습니다.

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

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

  • 새 CLI에서는 테넌트가 만들어지면 기본 테넌트가 자동으로 선택되지 않습니다. azsphere tenant select 명령을 실행하여 PC의 현재 사용자에 사용할 기본 테넌트 를 선택해야 합니다. 이는 디바이스 클레임처럼 실행 취소할 수 없는 일회성 작업을 수행할 때 기본 테넌트가 올바른 테넌트인지 확인하기 위한 것입니다.

    스크립트를 사용하는 경우 매개 변수를 사용하여 기본 테넌트 를 --tenant <tenant ID or tenant name> 선택할 수 있습니다.

    다음을 사용하여 스크립트 시작 시 기본 테넌트 설정:

    azsphere tenant select --tenant <tenant ID or tenant name>

    명령을 실행할 때 기본 테넌트를 덮어쓰거나 필요한 테넌트를 지정할 수도 있습니다. 예를 들어:

    azsphere get-support-data --destination logs.zip --tenant <tenant ID or tenant name>

  • 매개 변수는 --device-group 디바이스 그룹을 식별합니다. 디바이스 그룹 ID는 모든 제품에서 디바이스 그룹을 고유하게 식별하는 GUID를 제공합니다. 또는 제품 이름/<device-group-name 형식으로 <제품 이름> 및 디바이스 그룹 이름> 쌍을 사용할 수 있습니다. 이 이름 쌍은 특정 제품에 대한 디바이스 그룹을 고유하게 식별합니다.

  • 다음 명령은 클래식 CLI의 복합 명령이었습니다. 즉, 하나의 명령이 여러 작업을 수행했습니다. 새 CLI에서 두 명령을 실행해야 합니다.

  • 클래식 CLI -o 에서 또는 --output 매개 변수는 파일을 저장할 경로 및 파일 이름을 지정하는 데 사용됩니다. 새 Azure Sphere CLI에서는 입력 및 출력 경로를 지정하는 등의 --destination 컨텍스트별 매개 변수가 사용됩니다.

  • 클래식 CLI -d 에서 또는 --debug 매개 변수는 azsphere device app start 명령에 사용하여 디버그 모드에서 애플리케이션을 시작합니다. 새 Azure Sphere CLI --debug-mode 에서 매개 변수는 디버그 모드에서 애플리케이션을 시작하는 데 사용되며 --debug 매개 변수는 모든 디버그 로그를 표시하기 위해 로깅 세부 정보를 늘리기 위해 전역 매개 변수로 사용됩니다.

  • 클래식 CLI에서는 출력 형식을 제어할 수 없습니다. Azure Sphere CLI -o 에서 또는 --output 매개 변수는 CLI 출력의 서식을 지정할 출력 형식을 지정하는 데 사용됩니다.

  • 릴리스 21.02부터 명시적 버전 번호가 Azure Sphere CLI 제품 이름에서 제거되었습니다. 이 변경은 제품의 다른 버전을 참조하는 혼동을 제거합니다.

    • 이제 Azure Sphere CLI v2 이상을 "Azure Sphere CLI"라고만 합니다.
    • 이전 Azure Sphere CLI 버전(CLI v1 이하)을 이제 "Azure Sphere 클래식 CLI"라고 합니다.

  • 스크립트를 사용하는 경우 위에서 설명한 차이점으로 인해 새 Azure Sphere CLI와 호환되지 않을 수 있습니다. 스크립트가 새 CLI에서 올바르게 실행되도록 필수 업데이트를 만듭니다.

참고 항목