테넌트

Important

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

Azure Sphere 테넌트를 관리합니다.

Important

명령 및 azsphere tenant download-ca-certificateazsphere tenant download-ca-certificate-chainazsphere tenant download-validation-certificate 사용되지 않습니다. 대신 azsphere ca-certificate download, azsphere ca-certificate download-chain, azsphere ca-certificate download-proof 및 azsphere ca-certificate list를 사용해야 합니다.

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

연산	설명
create	새 테넌트를 만듭니다.
download-error-report	현재 테넌트 내의 디바이스에 대한 오류 정보를 반환합니다.
목록	사용 가능한 Azure Sphere 테넌트가 나열됩니다.
select	이 컴퓨터에서 사용할 기본 Azure Sphere 테넌트 선택
show-selected	이 컴퓨터의 기본 Azure Sphere 테넌트가 표시됩니다.
업데이트	테넌트의 이름과 같은 테넌트의 세부 정보를 업데이트합니다.

만들기

새 Azure Sphere 테넌트를 만듭니다. 이 명령을 실행하려면 연결된 디바이스가 필요합니다. 자세한 내용은 Azure Sphere 테넌트 만들기를 참조 하세요.

테넌트가 이미 있고 다른 테넌트를 원하는 경우 매개 변수를 --force-additional 사용합니다. 현재는 Azure Sphere 테넌트를 삭제할 수 없습니다. 테넌트가 만들어지면 azsphere 테넌트를 실행 하여 이 PC의 현재 사용자에 사용할 기본 테넌트를 선택합니다 . azsphere role add 명령을 사용하여 현재 Azure Sphere 테넌트에서 사용자에 대한 역할을 추가할 수 있습니다.

azsphere 테넌트 만들기 명령은 로컬로 연결된 Azure Sphere 디바이스에서 작동합니다. 디바이스가 연결되지 않은 상태에서 명령을 시도하면 오류가 발생합니다. 디바이스 ID는 테넌트를 만들 때 기록되며 디바이스당 하나의 테넌트만 만들 수 있습니다.

필수 매개 변수

매개 변수	형식	설명
-n, --name	문자열	테넌트 이름을 지정합니다. 테넌트의 이름을 지정할 때는 영숫자를 사용하세요. 특수 문자는 허용되지 않습니다. 이름은 50자를 초과하면 안 되며 대/소문자를 구분합니다.

선택적 매개 변수

매개 변수	형식	설명
-d, --device	문자열	여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다.
--force-additional	Boolean	새 Azure Sphere 테넌트를 강제로 만듭니다. 현재 계정을 사용하여 연결된 디바이스를 사용하여 새 Azure Sphere 테넌트를 만들려는 경우에만 이 명령을 사용합니다.
--disable-confirm-prompt	Boolean	사용자 확인 프롬프트를 사용하지 않도록 설정합니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오.
-h, --help	명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors	오류만 표시하고 경고를 표시하지 않습니다.
-o, --output	출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요.
--쿼리	JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

azsphere tenant create --name MyTenant

--force-additional 이 계정을 사용하여 연결된 디바이스를 사용하여 새 Azure Sphere 테넌트를 만들려는 경우 및 --disable-confirm-prompt 매개 변수를 사용합니다. 이전에 Azure Sphere 테넌트를 만드는 데 사용된 디바이스는 새 테넌트를 만드는 데 사용할 수 없습니다.

azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
 --> Tenant Name: MyTenant1
 --> Tenant ID:   768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.

팁

테넌트를 만든 후에는 azsphere 테넌트를 실행하여 이 PC의 현재 사용자에 사용할 기본 테넌트를 선택해야 합니다.

download-error-report

현재 테넌트 내의 디바이스에서 보고한 오류에 대한 정보를 반환합니다.

이 명령은 Azure Sphere Security Service 클라우드에서 이벤트 데이터를 가져오며 특정 디바이스에 대한 물리적 연결이 필요하지 않습니다. azsphere tenant download-error-report 명령은 현재 테넌트 컨텍스트에서 작동하며 해당 테넌트 내의 모든 디바이스에 대한 오류 보고서를 반환합니다.

참고 항목

최근에 보고된 이벤트를 다운로드할 수 있는 데 최대 24시간이 걸릴 수 있습니다. 자세한 내용은 오류 데이터 수집 및 해석을 참조 하세요.

선택적 매개 변수

매개 변수	형식	설명
--목적지	문자열	출력 파일의 경로 및 파일 이름을 지정합니다.
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오.
-h, --help	명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors	오류만 표시하고 경고를 표시하지 않습니다.
-o, --output	출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요.
--쿼리	JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

목록

Azure Sphere 테넌트가 나열됩니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오.
-h, --help	명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors	오류만 표시하고 경고를 표시하지 않습니다.
-o, --output	출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요.
--쿼리	JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

azsphere tenant list
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant              Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

선택

이 PC의 현재 사용자에 사용할 기본 Azure Sphere 테넌트 선택

현재 기본 테넌트를 표시하려면 azsphere tenant show-selected를 사용합니다.

필수 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오.
-h, --help	명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors	오류만 표시하고 경고를 표시하지 않습니다.
-o, --output	출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요.
--쿼리	JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

show-selected

이 PC에서 현재 사용자의 기본 Azure Sphere 테넌트에 대한 세부 정보를 표시합니다.

이것은 azsphere tenant select 명령을 사용하여 선택한 테넌트입니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오.
-h, --help	명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors	오류만 표시하고 경고를 표시하지 않습니다.
-o, --output	출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요.
--쿼리	JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

azsphere tenant show-selected
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

업데이트

테넌트의 이름과 같은 테넌트의 세부 정보를 업데이트합니다.

필수 매개 변수

매개 변수	형식	설명
-n, --new-name	문자열	테넌트에 대한 새 이름을 지정합니다. 테넌트의 이름을 지정할 때는 영숫자를 사용하세요. 특수 문자는 허용되지 않습니다. 이름은 50자를 초과하면 안 되며 대/소문자를 구분합니다.

선택적 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오.
-h, --help	명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors	오류만 표시하고 경고를 표시하지 않습니다.
-o, --output	출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 출력됩니다.table 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조 하세요.
--쿼리	JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제는 JMESPath 자습서 및 Azure CLI 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 --debug를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

팁

기본 테넌트를 선택하지 않은 경우 사용 가능한 테넌트 목록이 표시됩니다. 옵션 중 하나를 선택하여 기본 테넌트 설정