테 넌 트

아티클
08/09/2023

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

중요

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

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

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

만들

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

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

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

필수 매개 변수

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

선택적 매개 변수

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

전역 매개 변수

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

매개 변수	설명
--디버그	모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 `--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 명령 출력 쿼리 를 참조하세요.
--자세한	작업 중에 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 tenant select를 실행하여 이 PC의 현재 사용자에 사용할 기본 테넌트 를 선택해야 합니다.

download-error-report

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

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

참고

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

선택적 매개 변수

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

전역 매개 변수

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

매개 변수	설명
--디버그	모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 `--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 명령 출력 쿼리 를 참조하세요.
--자세한	작업 중에 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` 켜진 상태에서 생성된 출력을 제공합니다.
-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 명령 출력 쿼리 를 참조하세요.
--자세한	작업 중에 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` 켜진 상태에서 생성된 출력을 제공합니다.
-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 명령 출력 쿼리 를 참조하세요.
--자세한	작업 중에 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` 켜진 상태에서 생성된 출력을 제공합니다.
-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 명령 출력 쿼리 를 참조하세요.
--자세한	작업 중에 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` 켜진 상태에서 생성된 출력을 제공합니다.
-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 명령 출력 쿼리 를 참조하세요.
--자세한	작업 중에 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
 ------------------------------------ --------------------- -------------

팁

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

다음을 통해 공유

테 넌 트

만들

필수 매개 변수

선택적 매개 변수

예제

download-error-report

선택적 매개 변수

예제

목록

예제

선택

필수 매개 변수

예제

show-selected

예제

업데이트

필수 매개 변수

선택적 매개 변수

예제

추가 리소스