次の方法で共有

az devcenter dev customization-task

Note

このリファレンスは、Azure CLI (バージョン 2.75.0 以降) の 開発センター 拡張機能の一部です。 拡張機能は、az devcenter dev customization-task コマンドを初めて実行すると、自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

カスタマイズ タスクを管理します。

コマンド

名前 説明 型 状態
az devcenter dev customization-task list

カスタマイズ タスクを一覧表示します。

 Extension GA
az devcenter dev customization-task show

カスタマイズ タスクを取得します。

 Extension GA
az devcenter dev customization-task show-logs

カスタマイズ タスクのログを表示します。

 Extension GA
az devcenter dev customization-task validate

カスタマイズ タスクを検証します。

 Extension GA

az devcenter dev customization-task list

カスタマイズ タスクを一覧表示します。

az devcenter dev customization-task list --project --project-name
                                         [--dev-center --dev-center-name]
                                         [--endpoint]

例

デベロッパー センターを使用して一覧表示する

az devcenter dev customization-task list --dev-center-name "ContosoDevCenter" --project-name "DevProject"

エンドポイントを使用して一覧表示する

az devcenter dev customization-task list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject"

必須のパラメーター

--project --project-name

プロジェクトの名前。 az configure -d project=<project_name> を使用して既定値を構成します。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--dev-center --dev-center-name -d

デベロッパー センターの名前。 az configure -d dev-center=<dev_center_name> を使用して既定値を構成します。

--endpoint

開発者リソースの API エンドポイント。 az configure -d endpoint=<endpoint_uri> を使用して既定値を構成します。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az devcenter dev customization-task show

カスタマイズ タスクを取得します。

az devcenter dev customization-task show --catalog-name
                                         --name --task-name
                                         --project --project-name
                                         [--dev-center --dev-center-name]
                                         [--endpoint]

例

デベロッパー センターを使用する

az devcenter dev customization-task show --dev-center-name "ContosoDevCenter" --project-name "DevProject" --task-name "choco" --catalog-name "myCatalog"

エンドポイントを使用する

az devcenter dev customization-task show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --task-name "choco" --catalog-name "myCatalog"

必須のパラメーター

--catalog-name

カタログの名前です。

--name --task-name -n

タスクの名前。

--project --project-name

プロジェクトの名前。 az configure -d project=<project_name> を使用して既定値を構成します。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--dev-center --dev-center-name -d

デベロッパー センターの名前。 az configure -d dev-center=<dev_center_name> を使用して既定値を構成します。

--endpoint

開発者リソースの API エンドポイント。 az configure -d endpoint=<endpoint_uri> を使用して既定値を構成します。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az devcenter dev customization-task show-logs

カスタマイズ タスクのログを表示します。

az devcenter dev customization-task show-logs --customization-group-name --name
                                              --customization-task-id --task-id-t
                                              --dev-box --dev-box-name
                                              --project --project-name
                                              [--dev-center --dev-center-name]
                                              [--endpoint]
                                              [--user-id]

例

デベロッパー センターを使用する

az devcenter dev customization-task show-logs --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --customization-group-name "Provisioning" --customization-task-id "91835dc0-ef5a-4f58-9e3a-099aea8481f4" --user-id "00000000-0000-0000-0000-000000000000"

エンドポイントを使用する

az devcenter dev customization-task show-logs --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --customization-group-name "Provisioning" --customization-task-id "91835dc0-ef5a-4f58-9e3a-099aea8481f4" --user-id "00000000-0000-0000-0000-000000000000"

必須のパラメーター

--customization-group-name --name -n

カスタマイズ グループの名前。

--customization-task-id --task-id-t

開発ボックスの名前。

--dev-box --dev-box-name

開発ボックスの名前。

--project --project-name

プロジェクトの名前。 az configure -d project=<project_name> を使用して既定値を構成します。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--dev-center --dev-center-name -d

デベロッパー センターの名前。 az configure -d dev-center=<dev_center_name> を使用して既定値を構成します。

--endpoint

開発者リソースの API エンドポイント。 az configure -d endpoint=<endpoint_uri> を使用して既定値を構成します。

--user-id

ユーザーの AAD オブジェクト ID。 値が "me" の場合、ID は認証コンテキストから取得されます。

プロパティ 値
規定値: me
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az devcenter dev customization-task validate

カスタマイズ タスクを検証します。

az devcenter dev customization-task validate --project --project-name
                                             --tasks
                                             [--dev-center --dev-center-name]
                                             [--endpoint]
                                             [--no-wait]

例

デベロッパー センターを使用して検証する

az devcenter dev customization-task validate --dev-center-name "ContosoDevCenter" --project-name "DevProject" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]"

エンドポイントを使用して検証する

az devcenter dev customization-task validate --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]"

必須のパラメーター

--project --project-name

プロジェクトの名前。 az configure -d project=<project_name> を使用して既定値を構成します。

--tasks

タスクの Parameters オブジェクト。 予期される値: json-string/json-file/@json-file。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--dev-center --dev-center-name -d

デベロッパー センターの名前。 az configure -d dev-center=<dev_center_name> を使用して既定値を構成します。

--endpoint

開発者リソースの API エンドポイント。 az configure -d endpoint=<endpoint_uri> を使用して既定値を構成します。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ 値
規定値: False
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False