エリア パスを定義してチームに割り当てる

プロジェクト領域のパスを一覧表示します | プロジェクト領域のパスを追加します | チーム領域のパスを一覧表示します | チームエリアのパスを設定します | プロジェクト領域パスの名前を変更または移動します | チームからエリア パスを削除する

az boards area project list を使用して、プロジェクトに定義されている領域パスを一覧表示できます。 開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az boards area project list [--depth]
                            [--path]
                            [--project]

パラメーター

• depth: 省略可能。 一覧表示する子ノードの深さ。 例: --depth 3. 指定しない場合は、最上位レベルのエリア パスのみが返されます。
• path: 省略可能。 エリアの絶対パス。 \Area\ の直後に \ProjectName を指定する必要があり、それによって、このパスがイテレーション パスでないことが示されます。 たとえば、「 --path \ProjectName\Area\AreaName 」のように入力します。 ノード内にスペースが含まれる場合は、二重引用符で囲みます (例: --path "\Fabrikam Fiber\Area\Service Delivery\Performance")。 指定しない場合は、ルート レベルからのエリア パスが一覧表示されます。
• project: 任意。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

例

たとえば、次のコマンドは Fabrikam Fiber プロジェクトのエリア パスを深さ 3 まで一覧表示します。 その他の出力形式オプションについては、 Azure CLI コマンドの出力形式に関するページを参照してください。

az boards area project list --depth 3 --project 'Fabrikam Fiber' --output table
ID     Identifier                            Name                Path                                                Has Children
-----  ------------------------------------  ------------------  --------------------------------------------------  --------------
55302  91d8644a-e430-4fd0-aa95-742ea98770a3  Fabrikam Fiber      \Fabrikam Fiber\Area                                True
55373  26be05fd-e68a-4fcb-833f-497f6bee45f2  Service Delivery    \Fabrikam Fiber\Area\Service Delivery               True
55303  637dc203-0549-4415-9663-b6358ac27d21  Internet            \Fabrikam Fiber\Area\Service Delivery\Internet      False
55306  3f2067f9-684f-4121-8004-4a4745198b39  Voice               \Fabrikam Fiber\Area\Service Delivery\Voice         False
55372  4afc9ede-db1d-4703-8be6-95899b99be44  Email               \Fabrikam Fiber\Area\Service Delivery\Email         False
55381  f96d4738-c67e-42d0-bd4e-99f6b3fdeb22  Service Status      \Fabrikam Fiber\Area\Service Delivery\Service S...  False
55384  3a0c1189-6454-4ccd-9354-d72b653b7f74  TV                  \Fabrikam Fiber\Area\Service Delivery\TV            False
55380  4ea27e90-248c-41a0-8d11-eace6c9fd90e  Account Management  \Fabrikam Fiber\Area\Account Management             True
55382  4235f40d-753b-49dd-868f-82372065ec83  Shopping Cart       \Fabrikam Fiber\Area\Account Management\Shoppin...  False
55383  49d34650-6c65-446c-aff6-79edd3a21a75  Customer Profile    \Fabrikam Fiber\Area\Account Management\Custome...  False

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

az boards area project create を使用して、領域パスをプロジェクトに追加できます。 開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

--pathパラメーターを指定すると、新しいエリア パスは指定したパスの子ノードとして追加されます。 --path パラメーターを指定しない場合、新しいエリア パスはルート ノードの子ノードとして追加されます。

az boards area project create --name
                              [--path]
                              [--project]

パラメーター

• name: 必須。 領域パス名。
• path: 省略可能。 エリアの絶対パス。 例: --path \ProjectName\Area\AreaName。 指定しない場合は、ルート レベルでエリアが追加されます。
• project: 任意。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

例: JSON 形式

たとえば、次のコマンドは Fabrikam Fiber プロジェクトのルート ノードに Voice エリア パスを追加します。

az boards area project create --name Voice --project "Fabrikam Fiber"
{
  "attributes": null,
  "children": null,
  "hasChildren": false,
  "id": 55412,
  "identifier": "b00f86a2-3d49-4ad2-af01-da2537947baa",
  "name": "Voice",
  "path": "\\Fabrikam Fiber\\Area\\Voice",
  "structureType": "area",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Areas/Voice"
}

例: テーブル形式

同じコマンドをテーブル出力形式で表示した例を次に示します。

az boards area project create --name Voice --project "Fabrikam Fiber" --output table
ID     Identifier                            Name    Path                         Has Children
-----  ------------------------------------  ------  ---------------------------  --------------
55413  3c16691b-160c-4498-ab42-aa77b7f354fc  Voice  \Fabrikam Fiber\Area\Voice  False

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

az boards area team list を使用して、チームに定義されているエリア パスを 一覧表示できます。 開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az boards area team list --team
                         [--project] 

パラメーター

• チーム: 必須。 チームの名前または ID
• project: 任意。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

たとえば、次のコマンドは、Service Delivery チームのエリア パスを一覧表示します。 その他の出力形式オプションについては、Azure CLI コマンドの出力形式に関するページを参照してください。

az boards area team list --team "Service Delivery" --project "Fabrikam Fiber" --output table
Area                             Include sub areas    Is Default
-------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery  True                 True

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

既存のエリア パスを選択するか、[チームの設定] から新しいエリア パスまたは子エリア パスを作成できます。

1. プロジェクト 設定>Team 構成>Areas を選択します。

2. ページ上部のドロップダウン リストから構成するチームを選択します。

   ここでは、abrikam Fiber チームのエリアを表示しています。

   

3. チームで使用する 1 つ以上の領域 パスを選択します。

   

   この例では、プロジェクトのサブエリア パスを有効にします。 これにより、管理チームはすべてのチームにわたる進捗を追跡できるようになります。

   

4. 完了したら、チームのプロダクト バックログ ページを更新すると、チームに割り当てられた作業項目が表示されます。 割り当て状況を確認するには、表示される列にエリア パスを追加します。

   

   

az boards area team add を使用して、チームの既定のエリア パスを設定したり、エリア パスを追加したりすることができます。 開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az boards area team add --path  --team
                        [--include-sub-areas {false, true}]
                        [--project]
                        [--set-as-default]

パラメーター

• path: 必須。 エリアの絶対パス。 例: --path \ProjectName\AreaName.
• チーム: 必須。 チームの名前または ID
• include-sub-areas: 省略可能。 領域パスの子ノードを含めます。 指定できる値: false、true。
• project: 任意。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".
• set-as-default: 設定しなくても構いません。 チームの既定のエリア パスとして指定します。 既定値は False です。

例

たとえば、次のコマンドは、Fabrikam Fiber プロジェクトの Voice チームに音声領域パスを追加し、それを既定として設定して、サブエリアを含めます。

az boards area team add --path "\Fabrikam Fiber\Voice" --team Voice --project "Fabrikam Fiber" --include-sub-areas --set-as-default --include-sub-areas true --output table
Area                                   Include sub areas    Is Default
-------------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery\Voice  False                False
Fabrikam Fiber\Voice                   True                 True

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

プロジェクトでのエリア パスの名前変更と移動

az boards area project update コマンドを使用して、プロジェクトのエリア パスの名前を変更したり、移動したりできます。 開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az boards area project update --path
                              [--child-id]
                              [--name]
                              [--project]

• path: 必須。 エリアの絶対パス。 例: --path \ProjectName\AreaName.
• child-id: 省略可能。 既存のエリア パスを移動し、指定したパス名または ID の子ノードとして追加します。
• name: 省略可能。 エリア パスの新しい名前を指定します。
• project: 任意。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

例

たとえば、次のコマンドは、Fabrikam Fiber プロジェクトの音声領域パスの名前を Voice と Web に変更します。

az boards area project update --path "\Fabrikam Fiber\Area\Voice" --name "Voice and Web" --project "Fabrikam Fiber" --output table
ID     Identifier                            Name           Path                                Has Children
-----  ------------------------------------  -------------  ----------------------------------  --------------
55412  b00f86a2-3d49-4ad2-af01-da2537947baa  Voice and Web  \Fabrikam Fiber\Area\Voice and Web  False

チームからエリア パスを削除する

チームからエリア パスを削除するには、az boards area team removeを使用します。

az boards area team remove --path
                           --team
                           [--project]

パラメーター

• path: 必須。 エリアの絶対パス。 例: --path \ProjectName\AreaName.
• チーム: 必須。 チームの名前または ID
• project: 任意。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

例

たとえば、次のコマンドは、Fabrikam Fiber プロジェクトの Voice チームから \Service Delivery\Voice エリア パスを削除します。

az boards area team remove --path "\Fabrikam Fiber\Service Delivery\Voice" --team Voice --project "Fabrikam Fiber" --output table

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。