다음을 통해 공유


테넌트 관리

Important

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

Azure Sphere 테넌트는 조직에서 다른 고객의 디바이스와 격리된 상태로 Azure Sphere 디바이스를 원격으로 관리할 수 있는 안전한 방법을 제공합니다. 조직에서는 Azure Sphere 테넌트를 만든 후 각각의 해당 디바이스를 해당 테넌트에 요청하여 해당 디바이스를 원격으로 안전하게 관리할 수 있도록 해야 합니다.

필수 조건

  • Windows 또는 Linux용 Azure Sphere SDK를 설치합니다.
  • 이전에 테넌트를 만드는 데 사용되지 않은 클레임되지 않은 디바이스가 있어야 합니다.

Azure Sphere 테넌트 만들기

Azure Sphere 테넌트는 Azure Sphere 디바이스를 격리하고 애플리케이션을 구성하고 배포하는 방법을 제공합니다. 테넌트가 만들어지는 계정에는 테넌트에 대한 관리자 역할이 자동으로 할당됩니다.

  • 테넌트를 만든 후에는 삭제할 수 없으며 테넌트 간에 디바이스를 마이그레이션할 수 없습니다. 팀 또는 조직에 이미 Azure Sphere 테넌트가 있는 경우 추가 테넌트를 만드는 대신 액세스 권한을 요청하는 것이 좋습니다.

Azure Sphere 테넌트를 만들려면 다음을 수행합니다.

  1. USB로 Azure Sphere 디바이스를 컴퓨터에 연결합니다.

  2. PowerShell, Windows 명령 프롬프트 또는 Linux 명령 셸을 사용하여 Azure Sphere CLI를 엽니다.

  3. 여기에 있는 지침에 따라 CLI에 로그인합니다.

  4. 테넌트 만들기를 위해 다음 명령을 입력합니다.

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

    테넌트 이름을> "Contoso Ltd" 또는 "Contoso 식기 세척기 부서"와 같이 다른 사용자가 인식할 수 있는 이름으로 바꿉<니다. 테넌트 이름을 지정할 때는 영숫자 문자와 공백만 사용합니다. 공백을 포함하는 경우 이름을 따옴표로 묶습니다. 이름은 공백으로 시작하거나 50자를 초과해서는 안됩니다. 특수 문자는 허용되지 않습니다. 이름은 대/소문자를 구분합니다.

테넌트를 만들 때 Azure Sphere Security Service는 연결된 디바이스의 디바이스 ID를 기록합니다. 각 디바이스 ID를 사용하여 단 하나의 Azure Sphere 테넌트를 만들 수 있습니다.

계정에 이미 Azure Sphere 테넌트에 대한 액세스 권한이 있는 경우 명령이 실패하여 기존 테넌트를 사용하도록 권고합니다. 새 테넌트를 만들려는 경우 매개 변수를 사용하여 --force-additional 새 Azure Sphere 테넌트를 강제로 만들 수 있습니다.

azsphere tenant create 명령은 테넌트를 만들지만 테넌트에 디바이스를 클레임하지는 않습니다. 자세한 내용은 디바이스 클레임을 참조하세요.

API를 사용하여 테넌트를 만들려면 테넌트 - 만들기 작업을 사용합니다.

기본 테넌트 표시 및 선택

azsphere tenant show-selected를 실행하여 선택한 테넌트를 이 PC에서 기본값으로 사용해야 하는지 확인합니다.

기본 테넌트를 수정하거나 선택하려면 azsphere 테넌트 선택을 실행 합니다.

로그아웃하고 Azure Sphere Security Service에 다시 로그인하는 경우 기본 테넌트 선택 메시지가 표시될 수 있습니다. Azure Sphere 디바이스를 관리하는 데 사용할 계정으로 로그인해야 합니다.

테넌트 나열

다음 옵션을 사용하여 사용 가능한 Azure Sphere 테넌트 목록을 만들 수 있습니다.

다음 명령을 실행하여 사용 가능한 Azure Sphere 테넌트 목록을 표시합니다.

azsphere tenant list

API를 사용하여 테넌트를 나열하려면 테넌트 - 가져오기 작업을 사용합니다.

기존 테넌트 업데이트

Azure Sphere CLI 또는 Azure Sphere 공용 API를 사용하여 기존 Azure Sphere 테넌트 이름을 바꿀 수 있습니다. 테넌트의 이름을 지정할 때는 영숫자를 사용하세요. 특수 문자는 허용되지 않습니다. 이름은 50자를 초과하면 안 되며 대/소문자를 구분합니다.

CLI를 사용하여 테넌트를 업데이트하려면 다음 명령을 실행합니다.

azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2

기본 테넌트를 선택하지 않으면 메시지가 표시될 수 있습니다. 목록에서 필요한 테넌트 선택 및 명령을 다시 시도 합니다.

API를 사용하여 테넌트를 업데이트하려면 테넌트 - 패치 작업을 사용합니다.

테넌트에 대한 오류 보고서 다운로드

테넌트 내의 모든 디바이스에 대한 오류 보고서를 가져오려면 azsphere tenant download-error-report 명령을 사용합니다.