az pipelines agent

Note

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

エージェントを管理します。

コマンド

名前 説明 Status
az pipelines agent list

プール内のエージェントの一覧を取得します。

拡張 GA
az pipelines agent show

エージェントの詳細を表示します。

拡張 GA

az pipelines agent list

プール内のエージェントの一覧を取得します。

az pipelines agent list --pool-id
                        [--agent-name]
                        [--demands]
                        [--detect {false, true}]
                        [--include-assigned-request {false, true}]
                        [--include-capabilities {false, true}]
                        [--include-last-completed-request {false, true}]
                        [--org]

必須のパラメーター

--pool-id

エージェントを含むエージェント プール。

省略可能のパラメーター

--agent-name

エージェント名でフィルター処理します。

--demands

エージェントが満たすことができる要求でフィルター処理します。 コンマ区切りの一覧です。

--detect

組織を自動的に検出します。

承認された値: false, true
--include-assigned-request

エージェントの現在の作業に関する詳細を含めるかどうか。

承認された値: false, true
--include-capabilities

応答にエージェントの機能を含めるかどうか。

承認された値: false, true
--include-last-completed-request

エージェントの最新の完了した作業に関する詳細を含めるかどうか。

承認された値: false, true
--org --organization

Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使って既定の組織を構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です (例: https://dev.azure.com/MyOrganizationName/)。

グローバル パラメーター
--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 pipelines agent show

エージェントの詳細を表示します。

az pipelines agent show --agent-id
                        --pool-id
                        [--detect {false, true}]
                        [--include-assigned-request {false, true}]
                        [--include-capabilities {false, true}]
                        [--include-last-completed-request {false, true}]
                        [--org]

必須のパラメーター

--agent-id --id

情報を取得するエージェント ID。

--pool-id

エージェントを含むエージェント プール。

省略可能のパラメーター

--detect

組織を自動的に検出します。

承認された値: false, true
--include-assigned-request

エージェントの現在の作業に関する詳細を含めるかどうか。

承認された値: false, true
--include-capabilities

応答にエージェントの機能を含めるかどうか。

承認された値: false, true
--include-last-completed-request

エージェントの最新の完了した作業に関する詳細を含めるかどうか。

承認された値: false, true
--org --organization

Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使って既定の組織を構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です (例: https://dev.azure.com/MyOrganizationName/)。

グローバル パラメーター
--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 を使います。