Share via

ca-certificate

  • [アーティクル]

現在の Azure Sphere テナントの証明機関 (CA) 証明書を管理します。 詳細については、「 テナント CA 証明書の管理」を参照してください。

操作 説明
ダウンロード 現在の Azure Sphere テナントの CA 証明書を X.509 .cer ファイルとしてダウンロードします。
download-chain 現在の Azure Sphere テナントの CA 証明書チェーンを PKCS#7 .p7b ファイルとしてダウンロードします。
download-proof 現在の 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 使用して生成された出力を指定します。
-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 ca-certificate download --destination ca-cert.cer --index 1

必要な証明書をダウンロードする拇印を指定する例:

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

次のような出力が表示されます。

Succeeded

download-chain

現在の Azure Sphere テナントの CA 証明書チェーンを PKCS#7 .p7b ファイルとしてダウンロードします。

必須パラメーター

パラメーター 型 説明
--先 文字列 テナント CA 証明書チェーンを保存するパスとファイル名を指定します。 相対パスまたは絶対パスを指定できます。.p7b 拡張子を使用する必要があります。

省略可能なパラメーター

パラメーター 型 説明
--インデックス 整数 ダウンロードする証明書のインデックスを指定します。 を実行 azsphere ca-certificate list して、証明書とインデックス値を一覧表示します。 インデックスが指定されていない場合は、アクティブな証明書がダウンロードされます。 インデックス値または拇印を指定できます。
--拇印 文字列 ダウンロードする証明書の拇印を指定します。 を実行 azsphere ca-certificate list して、証明書と拇印の値を一覧表示します。 拇印が指定されていない場合は、アクティブな証明書がダウンロードされます。 インデックス値または拇印を指定できます。
-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 ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded

download-proof

提供されたコードと X.509 .cer ファイルとして使用するために、現在の Azure Sphere テナントの所有証明証明書をダウンロードします。 この証明書は、デバイス認証と構成証明プロセスの一部です。 Azure IoT で Azure Sphere デバイスを使用する方法の詳細については、「Azure Sphere で Azure IoT を使用する」を参照してください。

必須パラメーター

パラメーター 型 説明
--先 文字列 所有証明証明書を保存するパスとファイル名を指定します。 ファイルパスには絶対パスまたは相対パスを指定できますが、.cer 拡張子を使用する必要があります。
--verification-code 文字列 証明書の生成時に使用する Azure Sphere セキュリティ サービスの検証コードを指定します。

省略可能なパラメーター

パラメーター 型 説明
--インデックス 整数 ダウンロードする証明書のインデックスを指定します。 を実行 azsphere ca-certificate list して、証明書とインデックス値を一覧表示します。 インデックスが指定されていない場合は、アクティブな証明書がダウンロードされます。 インデックス値または拇印を指定できます。
--拇印 文字列 ダウンロードする証明書の拇印を指定します。 を実行 azsphere ca-certificate list して、証明書と拇印の値を一覧表示します。 拇印が指定されていない場合は、アクティブな証明書がダウンロードされます。 インデックス値または拇印を指定できます。
-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 ca-certificate download-proof --destination validation.cer  --verification-code 123412341234 --index 1
Succeeded

リスト

現在のテナントのすべての証明書を一覧表示します。

省略可能なパラメーター

パラメーター 型 説明
-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 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
 ----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------