az boards work-item

  • Referenz

Hinweis

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 einen Az Boards-Arbeitsaufgabenbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Arbeitselementen

Befehle

Name Beschreibung Typ Status
az boards work-item create

Erstellen Sie eine Arbeitsaufgabe.

 Durchwahl Allgemein verfügbar
az boards work-item delete

Löschen einer Arbeitsaufgabe.

 Durchwahl Allgemein verfügbar
az boards work-item relation

Verwalten der Beziehungen von Arbeitselementen

 Durchwahl Allgemein verfügbar
az boards work-item relation add

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

 Durchwahl Allgemein verfügbar
az boards work-item relation list-type

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

 Durchwahl Allgemein verfügbar
az boards work-item relation remove

Entfernen sie Beziehungen aus der Arbeitsaufgabe.

 Durchwahl Allgemein verfügbar
az boards work-item relation show

Arbeitsaufgabe abrufen, Beziehungen mit Anzeigenamen ausfüllen.

 Durchwahl Allgemein verfügbar
az boards work-item show

Details für eine Arbeitsaufgabe anzeigen.

 Durchwahl Allgemein verfügbar
az boards work-item update

Arbeitsaufgaben aktualisieren.

 Durchwahl Allgemein verfügbar

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]
                           [--project]
                           [--reason]

Erforderliche Parameter

--title

Der Titel des Arbeitselements.

--type

Name des Arbeitsaufgabentyps (z. B. Fehler).

Optionale Parameter

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

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 unter

--iteration

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

--open

Öffnet das Arbeitselement im Standardwebbrowser.

Standardwert: False
--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. 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 sie nicht als Standard konfiguriert oder über die Git-Konfiguration verwendet werden.

--reason

Der Grund für den Zustand des Arbeitselements.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az boards work-item delete

Löschen einer Arbeitsaufgabe.

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

Erforderliche Parameter

--id

Eindeutige ID der Arbeitsaufgabe.

Optionale Parameter

--destroy

Dieses Arbeitselement endgültig löschen.

Standardwert: False
--detect

Organisation automatisch erkennen.

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

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. 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 sie nicht als Standard konfiguriert oder über die Git-Konfiguration verwendet werden.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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]

Erforderliche Parameter

--id

Die ID des Arbeitselements.

Optionale Parameter

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

Zulässige Werte: false, true
--expand

Die Erweiterungsparameter für Arbeitsaufgabenattribute.

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

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

--open

Öffnet das Arbeitselement im Standardwebbrowser.

Standardwert: False
--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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]
                           [--reason]
                           [--state]
                           [--title]

Erforderliche Parameter

--id

Die ID der zu aktualisierenden Arbeitsaufgabe.

Optionale Parameter

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

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 unter

--iteration

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

--open

Öffnet das Arbeitselement im Standardwebbrowser.

Standardwert: False
--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.