다음을 통해 공유


ca-certificate

Important

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

현재 Azure Sphere 테넌트에 대한 CA(인증 기관) 인증서를 관리합니다. 자세한 내용은 테넌트 CA 인증서 관리를 참조 하세요.

연산 설명
download 현재 Azure Sphere 테넌트에 대한 CA 인증서를 X.509 .cer 파일로 다운로드합니다.
다운로드 체인 현재 Azure Sphere 테넌트에 대한 CA 인증서 체인을 PKCS#7 .p7b 파일로 다운로드합니다.
다운로드 증명 현재 Azure Sphere 테넌트에 대한 소유 증명 인증서를 X.509 .cer 파일로 다운로드합니다.
목록 현재 Azure Sphere 테넌트에 대한 모든 인증서를 나열합니다.

다운로드로 사용 가능한 제품 설명서에서 데이터 공급자 설치 섹션을 참조하세요

현재 Azure Sphere 테넌트에 대한 CA 인증서를 X.509 .cer 파일로 다운로드합니다.

필수 매개 변수

매개 변수 형식 설명
--목적지 문자열 테넌트 CA 인증서를 저장할 경로 및 파일 이름을 지정합니다. 파일 경로는 절대 또는 상대 경로일 수 있지만 .cer 확장명이 있어야 합니다.

선택적 매개 변수

매개 변수 형식 설명
--색인 정수 다운로드할 인증서의 인덱스를 지정합니다. 인증서 및 인덱스 값을 나열하려면 실행 azsphere ca-certificate list 합니다. 인덱스가 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
--지문 문자열 다운로드할 인증서의 지문을 지정합니다. 인증서 및 지문 값을 나열하려면 실행 azsphere ca-certificate list 합니다. 지문이 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
-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 ca-certificate download --destination ca-cert.cer --index 1

필요한 인증서를 다운로드하기 위해 지문을 지정하는 예제:

azsphere ca-certificate download --destination ca-cert.cer --thumbprint <value>

다음과 유사한 출력이 표시됩니다.

Succeeded

다운로드 체인

현재 Azure Sphere 테넌트에 대한 CA 인증서 체인을 PKCS#7 .p7b 파일로 다운로드합니다.

필수 매개 변수

매개 변수 형식 설명
--목적지 문자열 테넌트 CA 인증서 체인을 저장할 경로 및 파일 이름을 지정합니다. 상대 또는 절대 경로를 제공할 수 있으며 .p7b 확장을 사용해야 합니다.

선택적 매개 변수

매개 변수 형식 설명
--색인 정수 다운로드할 인증서의 인덱스를 지정합니다. 인증서 및 인덱스 값을 나열하려면 실행 azsphere ca-certificate list 합니다. 인덱스가 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
--지문 문자열 다운로드할 인증서의 지문을 지정합니다. 인증서 및 지문 값을 나열하려면 실행 azsphere ca-certificate list 합니다. 지문이 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
-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 ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded

다운로드 증명

제공된 코드 및 X.509 .cer 파일로 사용할 현재 Azure Sphere 테넌트에 대한 소유 증명 인증서를 다운로드합니다. 이 인증서는 디바이스 인증 및 증명 프로세스의 일부입니다. Azure IoT에서 Azure Sphere 디바이스를 사용하는 방법에 대한 자세한 내용은 Azure Sphere에서 Azure IoT 사용을 참조 하세요.

필수 매개 변수

매개 변수 형식 설명
--목적지 문자열 소유 증명 인증서를 저장할 경로 및 파일 이름을 지정합니다. 파일 경로는 절대 또는 상대 경로일 수 있지만 .cer 확장자를 사용해야 합니다.
--verification-code 문자열 인증서를 생성할 때 사용할 Azure Sphere Security Service의 확인 코드를 지정합니다.

선택적 매개 변수

매개 변수 형식 설명
--색인 정수 다운로드할 인증서의 인덱스를 지정합니다. 인증서 및 인덱스 값을 나열하려면 실행 azsphere ca-certificate list 합니다. 인덱스가 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
--지문 문자열 다운로드할 인증서의 지문을 지정합니다. 인증서 및 지문 값을 나열하려면 실행 azsphere ca-certificate list 합니다. 지문이 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
-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 ca-certificate download-proof --destination validation.cer  --verification-code 123412341234 --index 1
Succeeded

목록

현재 테넌트에 대한 모든 인증서를 나열합니다.

선택적 매개 변수

매개 변수 형식 설명
-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 ca-certificate list
 ----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
 Index Thumbprint                               CertificateDetails                                              Status StartDate         EndDate
 =========================================================================================================================================================
 1     <value>                                  CN: Microsoft Azure Sphere <tenant-ID>                          Active 09/06/2020 17:39:40 09/06/2022 17:39:40
                                                O: Microsoft Corporation
                                                L: Redmond
                                                ST: Washington
                                                C: US
 ----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
 2     <value>                                  CN: Microsoft Azure Sphere <tenant-ID>                          Ready 29/04/2020 22:51:47 29/04/2022 22:51:47
                                                O: Microsoft Corporation
                                                L: Redmond
                                                ST: Washington
                                                C: US
 ----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------