Definieren von Bereichspfaden und Zuweisen zu einem Team

Projektbereichspfade auflisten | Hinzufügen eines Projektbereichspfads | Pfade für | Teambereiche auflistenFestlegen von Teambereichspfaden | Umbenennen oder Verschieben eines Projektbereichspfads | Entfernen des Bereichspfads aus einem Team

Sie können für ein Projekt definierte Bereichspfade mithilfe des Befehls "az boards area project list" auflisten. Informationen zu den ersten Schritten mit der CLI finden Sie unter "Erste Schritte mit Azure DevOps CLI".

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

Parameter

• Tiefe: Optional. Tiefe der untergeordneten Knoten, die aufgelistet werden sollen. Beispiel: --depth 3. Wird dieser Parameter nicht angegeben, werden nur die Bereichspfade der obersten Ebene zurückgegeben.
• pfad: Optional. Der absolute Pfad eines Bereichs. \Area\ muss dem \ProjectName folgen, der diesen Pfad von einem Iterationspfad unterscheidet. Beispiel: --path \ProjectName\Area\AreaName. Wenn Leerzeichen innerhalb eines Knotens verwendet werden, schließen Sie sie in doppelte Anführungszeichen ein, zum Beispiel --path "\Fabrikam Fiber\Area\Service Delivery\Performance". Wird dieser Parameter nicht angegeben, werden Bereichspfade ab der Stammebene aufgelistet.
• Projekt: Optional. Name oder ID des Projekts. Beispiel: --project "Fabrikam Fiber".

Beispiel

Der folgende Befehl listet beispielsweise die Bereichspfade bis zu einer Tiefe von 3 für das Fabrikam Fiber-Projekt auf. Weitere Ausgabeformatoptionen finden Sie unter Ausgabeformate für Azure CLI-Befehle.

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-Befehle werden für Azure DevOps Server nicht unterstützt.

Sie können einem Projekt Flächenpfade hinzufügen, indem Sie az boards area project erstellen. Informationen zu den ersten Schritten finden Sie unter "Erste Schritte mit Azure DevOps CLI".

Wenn Sie den Parameter --path angeben, wird der neue Bereichspfad dem angegebenen Pfad als untergeordneter Knoten hinzugefügt. Wenn Sie den Parameter --path nicht angeben, wird der neue Bereichspfad dem Stammknoten als untergeordneter Knoten hinzugefügt.

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

Parameter

• Name: Erforderlich. Name des Bereichspfads
• pfad: Optional. Der absolute Pfad eines Bereichs. Beispiel: --path \ProjectName\Area\AreaName. Wenn nichts angegeben ist, wird ein Bereich auf Stammebene hinzugefügt.
• Projekt: Optional. Name oder ID des Projekts. Beispiel: --project "Fabrikam Fiber".

Beispiel: JSON-Format

Mit dem folgenden Befehl wird beispielsweise der Voice-Bereichspfad zum Fabrikam Fiber-Projekt im Stammknoten hinzugefügt:

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

Beispiel: Tabellenformat

Und hier ist derselbe Befehl mit dem Tabellenausgabeformat.

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-Befehle werden für Azure DevOps Server nicht unterstützt.

Sie können die für ein Team definierten Bereichspfade mit az boards area team list auflisten. Informationen zu den ersten Schritten finden Sie unter "Erste Schritte mit Azure DevOps CLI".

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

Parameter

• team: Erforderlich. Name oder ID des Teams.
• Projekt: Optional. Name oder ID des Projekts. Beispiel: --project "Fabrikam Fiber".

Der folgende Befehl listet beispielsweise die Bereichspfade für das Service Delivery-Team auf. Weitere Ausgabeformatoptionen finden Sie unter Ausgabeformate für Azure CLI-Befehle

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-Befehle werden für Azure DevOps Server nicht unterstützt.

Sie können über die Teameinstellungen vorhandene Bereichspfade auswählen oder neue oder untergeordnete Bereichspfade erstellen.

1. Wählen Sie Projekteinstellungen>Teamkonfiguration>Bereiche.

2. Wählen Sie in der Dropdownliste oben auf der Seite das Team aus, das Sie konfigurieren möchten.

   Hier werden die Bereiche für das Fabrikam Fiber-Team gezeigt.

   

3. Wählen Sie einen oder mehrere Bereichspfade aus, die für das Team aktiviert werden sollen.

   

   In diesem Fall entscheiden wir uns dafür, die Unterbereichspfade für das Projekt zu aktivieren. Das Managementteam kann jetzt den Fortschritt für alle Teams nachverfolgen.

   

4. Wenn Sie fertig sind, aktualisieren Sie die Produktbacklogseite für das Team. Ihnen werden jetzt die Arbeitselemente angezeigt, die dem Team zugewiesen sind. Fügen Sie den Bereichspfad zu den angezeigten Spalten hinzu, um die Zuordnungen für Arbeitselemente anzuzeigen.

   

   

Sie können den Standardbereichspfad für ein Team festlegen oder einen Bereichspfad hinzufügen, indem Sie az boards area team add verwenden. Informationen zu den ersten Schritten finden Sie unter "Erste Schritte mit Azure DevOps CLI".

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

Parameter

• pfad: Erforderlich. Der absolute Pfad eines Bereichs. Beispiel: --path \ProjectName\AreaName.
• team: Erforderlich. Name oder ID des Teams.
• include sub areas: Optional. Schließen Sie untergeordnete Knoten des Bereichspfads ein. Zulässige Werte: false, true
• Projekt: Optional. Name oder ID des Projekts. Beispiel: --project "Fabrikam Fiber".
• set-as-default: Optional. Geben Sie den Standardbereichspfad für das Team an. Standardwert: False.

Beispiel

Mit dem folgenden Befehl wird beispielsweise der Voice-Bereichspfad zum Voice-Team für das Fabrikam Fiber-Projekt hinzugefügt und als Standard festgelegt, und es werden Unterbereiche eingeschlossen.

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-Befehle werden für Azure DevOps Server nicht unterstützt.

Umbenennen eines Bereichspfads oder Verschieben eines Bereichspfads aus einem Projekt

Sie können einen Bereichspfad für ein Projekt mithilfe des Befehls az boards area project update umbenennen oder verschieben. Informationen zu den ersten Schritten finden Sie unter "Erste Schritte mit Azure DevOps CLI".

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

• pfad: Erforderlich. Der absolute Pfad eines Bereichs. Beispiel: --path \ProjectName\AreaName.
• child-id: Optional. Verschiebt einen vorhandenen Bereichspfad und fügt ihn als untergeordneten Knoten für den angegebenen Pfadnamen oder die angegebene ID hinzu.
• name: Optional. Gibt den neuen Namen des Bereichspfads an.
• Projekt: Optional. Name oder ID des Projekts. Beispiel: --project "Fabrikam Fiber".

Beispiel

Der folgende Befehl benennt beispielsweise den VoIP-Bereichspfad in VoIP und Web für das Fabrikam Fiber-Projekt um.

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

Entfernen eines Bereichspfads aus einem Team

Um einen Bereichspfad aus einem Team zu entfernen, verwenden Sie az boards area team remove.

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

Parameter

• pfad: Erforderlich. Der absolute Pfad eines Bereichs. Beispiel: --path \ProjectName\AreaName.
• team: Erforderlich. Name oder ID des Teams.
• Projekt: Optional. Name oder ID des Projekts. Beispiel: --project "Fabrikam Fiber".

Beispiel

Mit dem folgenden Befehl wird beispielsweise der Pfad \Service Delivery\Voice aus dem Voice-Team des Fabrikam Fiber-Projekts entfernt.

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

Azure DevOps CLI-Befehle werden für Azure DevOps Server nicht unterstützt.