クラシック CLI から Azure Sphere CLI への移行
Azure Sphere クラシック CLI を引き続き使用している場合は、新しい Azure Sphere CLI に移行することをお勧めします。 現在、両方のバージョンの CLI を同時にインストールして使用できますが、クラシック CLI は更新または保守されなくなり、(2022 年の終わりより前ではなく) 将来 SDK から削除されます。 これらの違いを理解し、中断を回避するために、2022 年末までにプロセスとスクリプトを移行することをお勧めします。
最新の SDK に更新するには、「 Linux に Azure Sphere SDK をインストール する」または「 Azure Sphere SDK for Windows をインストールする」を参照してください。
Windows で Azure Sphere CLI を使用するには、PowerShell または標準の Windows コマンド プロンプトを使用します。 Linux の場合は、任意のコマンド シェルを使用します。 詳細については、「 Azure Sphere CLI の実行」を参照してください。
Windows では、廃止されるカスタム Azure Sphere クラシック開発者コマンド プロンプト (Azure Sphere の [スタート] メニューのショートカットとして使用できます) は、Azure Sphere クラシック CLI でのみ使用できます。 詳細については、「 Azure Sphere クラシック CLI の実行」を参照してください。
主な違い
Azure Sphere クラシック CLI では、複数のパラメーターを使用して各オブジェクトの種類を識別できます。 Azure Sphere CLI では、各オブジェクトの種類を識別するために 1 つのパラメーターが使用されます。 つまり、名前または ID を使用してパラメーター値を指定できます。 これは、および パラメーターに
--device--tenant--product対して--device-group実装されています。オブジェクト型 Azure Sphere CLI Azure Sphere クラシック CLI (廃止) デバイス --device--deviceid、--deviceip、または--devicelocationデバイス グループ --device-group--devicegroupidまたは--devicegroupname製品 --product--productidまたは--productnameテナント --tenant--tenantidコマンドの短い形式は、クラシック バージョンでサポートされています。 Azure Sphere CLI では、 タブ補完 または対話型機能を使用して、使用可能 な コマンドの一覧を表示することをお勧めします。 たとえば、クラシック CLI ではまたは
azsphere dev edvコマンドをazsphere device enable-development使用できますが、新しい Azure Sphere CLI ではオートコンプリートを使用してコマンドをすばやく入力azsphere device enable-developmentできます。一部のコマンドでは、1 つのパラメーターに複数の値を使用できます。 Azure Sphere CLI では、1 つのパラメーターを指定し、その後にスペースで区切られた値の一覧を指定し、Azure Sphere クラシック CLI では値の一覧をコンマで区切ります。 例えば：
azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2新しい CLI では、テナントの作成時に既定 のテナントが自動的に選択されません。 azsphere tenant select コマンドを実行して、PC 上の現在のユーザーに使用する既定のテナントを選択する必要があります。 これは、 デバイスの要求のように元に戻すことができない 1 回限りの操作を実行するときに、既定のテナントが正しく使用されるようにするためです。
スクリプトを使用する場合は、 パラメーターを使用して既定のテナントを
--tenant <tenant ID or tenant name>選択できます。次を使用して、スクリプトの開始時に既定のテナントを設定します。
azsphere tenant select --tenant <tenant ID or tenant name>コマンドを実行するときに、既定のテナントを上書きしたり、必要なテナントを指定したりすることもできます。 例えば：
azsphere get-support-data --destination logs.zip --tenant <tenant ID or tenant name>-
パラメーターは
--device-group、デバイス グループを識別します。 デバイス グループ ID は GUID を提供します。この GUID は、すべての製品にわたってデバイス グループを一意に識別します。 または、製品名とデバイス グループ名のペアを<製品名/<device-group-name>> 形式で使用することもできます。 この名前のペアは、特定の製品のデバイス グループを一意に識別します。 次のコマンドは、クラシック CLI の複合コマンドでした。 つまり、1 つのコマンドで複数のタスクが実行されました。 新しい CLI では、2 つのコマンドを実行する必要があります。
クラシック CLI では、 azsphere device-group deployment create コマンドによってイメージ パッケージがアップロードされ、新しいデプロイが作成されました。
新しい CLI では、次の手順を実行する必要があります。
- azsphere image add を使用して、イメージ パッケージを Azure Sphere テナントにアップロードします。
- azsphere device-group deployment create を使用して、アップロードされたイメージの デバイス グループの新しいデプロイを作成します。
クラシック CLI では、 azsphere device capability download --select コマンドをダウンロードし、アタッチされたデバイスのデバイス機能構成を一時的に選択します。
新しい CLI では、次の手順を実行する必要があります。
- azsphere デバイス機能のダウンロードを使用して 、機能ファイルをダウンロードします。
- azsphere device capability select を使用して、機能を選択します。
クラシック CLI では、 azsphere device capability download --apply コマンドがダウンロードされ、アタッチされたデバイスのデバイス機能構成が適用されます。
新しい CLI では、次の手順を実行する必要があります。
- azsphere デバイス機能のダウンロードを使用して 、機能ファイルをダウンロードします。
- azsphere デバイス機能更新プログラムを使用して 、機能を適用します。
クラシック CLI では、
-oまたは--outputパラメーターを使用して、ファイルを保存するパスとファイル名を指定します。 新しい Azure Sphere CLI では、入力パスと出力パスの指定など--destination、コンテキスト固有のパラメーターが使用されます。クラシック CLI では、
-dazsphere device app start コマンドで または--debugパラメーターを使用して、デバッグ モードでアプリケーションを起動します。 新しい Azure Sphere CLI では、パラメーターを--debug-mode使用してデバッグ モードでアプリケーションを起動し、パラメーターを--debugグローバル パラメーターとして使用してログ記録の詳細度を高め、すべてのデバッグ ログを表示します。クラシック CLI では、出力形式を制御する必要はありません。 Azure Sphere CLI では、
-oまたは--outputパラメーターを使用して、 CLI 出力の書式を設定する出力形式を指定します。リリース 21.02 以降では、Azure Sphere CLI 製品名から明示的なバージョン番号が削除されました。 この変更により、製品のさまざまなバージョンを参照する場合の混乱が解消されます。
- Azure Sphere CLI v2 以降は、"Azure Sphere CLI" と呼ばれるようになりました。
- 以前の Azure Sphere CLI バージョン (CLI v1 以降) は、"Azure Sphere クラシック CLI" と呼ばれるようになりました。
スクリプトを使用している場合は、上記の違いにより、新しい Azure Sphere CLI と互換性がない可能性があります。 新しい CLI でスクリプトを正しく実行するために必要な更新を行います。