Freigeben über


az boards work-item

Note

Diese Referenz ist Teil der Azure-devops-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie ein Az Boards-Arbeitselement Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten von Arbeitselementen

Befehle

Name Beschreibung Typ Status
az boards work-item create

Erstellen Sie eine Arbeitsaufgabe.

Extension GA
az boards work-item delete

Löschen einer Arbeitsaufgabe.

Extension GA
az boards work-item relation

Verwalten von Arbeitsaufgabenbeziehungen.

Extension GA
az boards work-item relation add

Fügen Sie Beziehung(en) zur Arbeitsaufgabe hinzu.

Extension GA
az boards work-item relation list-type

Arbeitsaufgabenbeziehungen auflisten, die in der Organisation unterstützt werden.

Extension GA
az boards work-item relation remove

Entfernen sie Beziehungen aus der Arbeitsaufgabe.

Extension GA
az boards work-item relation show

Arbeitsaufgabe abrufen, Beziehungen mit Anzeigenamen ausfüllen.

Extension GA
az boards work-item show

Details für eine Arbeitsaufgabe anzeigen.

Extension GA
az boards work-item update

Arbeitsaufgaben aktualisieren.

Extension GA

az boards work-item create

Erstellen Sie eine Arbeitsaufgabe.

az boards work-item create --title
                           --type
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--detect {false, true}]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--org --organization]
                           [--project]
                           [--reason]

Erforderliche Parameter

--title

Der Titel des Arbeitselements.

--type

Name des Arbeitsaufgabentyps (z. B. Fehler).

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--area

Bereich, dem die Arbeitsaufgabe zugewiesen ist (z. B. Demos).

--assigned-to

Der Name der Person, der die Arbeitsaufgabe zugewiesen ist (z. B. fabrikam).

--description -d

Die Beschreibung des Arbeitselements.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
Zulässige Werte: false, true
--discussion

Kommentar, der einer Diskussion in einem Arbeitselement hinzugefügt werden soll.

--fields -f

Leerzeichentrennte "field=value"-Paare für benutzerdefinierte Felder, die Sie festlegen möchten. Bei mehreren Feldern: "field1=value1" "field2=value2". Weitere Informationen zu Feldern finden Sie https://aka.ms/azure-devops-cli-field-api.

--iteration

Iterationspfad der Arbeitsaufgabe (z. B. Demos\Iteration 1).

--open

Öffnet das Arbeitselement im Standardwebbrowser.

Eigenschaft Wert
Standardwert: False
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn es nicht als Standard konfiguriert oder über git config übernommen wurde.

--reason

Der Grund für den Zustand des Arbeitselements.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az boards work-item delete

Löschen einer Arbeitsaufgabe.

az boards work-item delete --id
                           [--destroy]
                           [--detect {false, true}]
                           [--org --organization]
                           [--project]
                           [--yes]

Erforderliche Parameter

--id

Eindeutige ID der Arbeitsaufgabe.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--destroy

Dieses Arbeitselement endgültig löschen.

Eigenschaft Wert
Standardwert: False
--detect

Organisation automatisch erkennen.

Eigenschaft Wert
Zulässige Werte: false, true
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn es nicht als Standard konfiguriert oder über git config übernommen wurde.

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az boards work-item show

Details für eine Arbeitsaufgabe anzeigen.

az boards work-item show --id
                         [--as-of]
                         [--detect {false, true}]
                         [--expand {all, fields, links, none, relations}]
                         [--fields]
                         [--open]
                         [--org --organization]

Erforderliche Parameter

--id

Die ID des Arbeitselements.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--as-of

Arbeitsaufgabendetails ab einem bestimmten Datum und einer bestimmten Uhrzeit. Geben Sie eine Datums- oder Datums-Uhrzeitzeichenfolge an. Geht von der lokalen Zeitzone aus. Beispiel: '2019-01-20', '2019-01-20 00:20:00'. Fügen Sie für UTC an die Datums-Uhrzeitzeichenfolge "2019-01-20 00:20:00 UTC" an.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
Zulässige Werte: false, true
--expand

Die Erweiterungsparameter für Arbeitsaufgabenattribute.

Eigenschaft Wert
Standardwert: all
Zulässige Werte: all, fields, links, none, relations
--fields -f

Durch Trennzeichen getrennte Liste der angeforderten Felder. Example:System.Id,System.AreaPath. Weitere Informationen zu Feldern finden Sie https://aka.ms/azure-devops-cli-field-api.

--open

Öffnet das Arbeitselement im Standardwebbrowser.

Eigenschaft Wert
Standardwert: False
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az boards work-item update

Arbeitsaufgaben aktualisieren.

az boards work-item update --id
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--detect {false, true}]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--org --organization]
                           [--reason]
                           [--state]
                           [--title]

Erforderliche Parameter

--id

Die ID der zu aktualisierenden Arbeitsaufgabe.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--area

Bereich, dem die Arbeitsaufgabe zugewiesen ist (z. B. Demos).

--assigned-to

Der Name der Person, der die Arbeitsaufgabe zugewiesen ist (z. B. fabrikam).

--description -d

Die Beschreibung des Arbeitselements.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
Zulässige Werte: false, true
--discussion

Kommentar, der einer Diskussion in einem Arbeitselement hinzugefügt werden soll.

--fields -f

Leerzeichentrennte "field=value"-Paare für benutzerdefinierte Felder, die Sie festlegen möchten. Weitere Informationen zu Feldern finden Sie https://aka.ms/azure-devops-cli-field-api.

--iteration

Iterationspfad der Arbeitsaufgabe (z. B. Demos\Iteration 1).

--open

Öffnet das Arbeitselement im Standardwebbrowser.

Eigenschaft Wert
Standardwert: False
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--reason

Der Grund für den Zustand des Arbeitselements.

--state

Status des Arbeitselements (z. B. aktiv).

--title

Der Titel des Arbeitselements.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False