az devcenter dev customization-group

  • リファレンス

Note

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

カスタマイズ グループを管理します。

コマンド

名前 説明 型 Status
az devcenter dev customization-group create

カスタマイズ グループを作成します。

 拡張子 GA
az devcenter dev customization-group list

開発ボックスにカスタマイズ グループを一覧表示します。

 拡張子 GA
az devcenter dev customization-group show

カスタマイズ グループを取得します。

 拡張子 GA

az devcenter dev customization-group create

カスタマイズ グループを作成します。

az devcenter dev customization-group create --customization-group-name
                                            --dev-box
                                            --project
                                            [--dev-center]
                                            [--endpoint]
                                            [--tasks]
                                            [--user-id]

例

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

az devcenter dev customization-group create --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

エンドポイントを使用して作成する

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

必須のパラメーター

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

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

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

開発ボックスの名前。

--project --project-name

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

省略可能のパラメーター

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

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

--endpoint

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

--tasks

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

--user-id

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

既定値: me
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az devcenter dev customization-group list

開発ボックスにカスタマイズ グループを一覧表示します。

az devcenter dev customization-group list --dev-box
                                          --project
                                          [--dev-center]
                                          [--endpoint]
                                          [--include-tasks {false, true}]
                                          [--user-id]

例

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

az devcenter dev customization-group list --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000" --include-tasks

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

az devcenter dev customization-group list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000" --include-tasks

必須のパラメーター

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

開発ボックスの名前。

--project --project-name

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

省略可能のパラメーター

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

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

--endpoint

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

--include-tasks
プレビュー

応答にタスク情報を含める省略可能なパラメーター。

承認された値: false, true
--user-id

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

既定値: me
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az devcenter dev customization-group show

カスタマイズ グループを取得します。

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

例

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

az devcenter dev customization-group show --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

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

az devcenter dev customization-group show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

必須のパラメーター

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

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

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

開発ボックスの名前。

--project --project-name

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

省略可能のパラメーター

--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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。