Compartir a través de


az boards work-item

Nota:

Esta referencia forma parte de la extensión azure-devops para la CLI de Azure (versión 2.30.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az boards work-item . Obtenga más información sobre las extensiones.

Administrar elementos de trabajo.

Comandos

Nombre Description Tipo Estado
az boards work-item create

Cree un elemento de trabajo.

Extensión GA
az boards work-item delete

Eliminar un elemento de trabajo.

Extensión GA
az boards work-item relation

Administrar las relaciones de los elementos de trabajo.

Extensión GA
az boards work-item relation add

Agregue relaciones al elemento de trabajo.

Extensión GA
az boards work-item relation list-type

Enumerar las relaciones de elementos de trabajo admitidas en la organización.

Extensión GA
az boards work-item relation remove

Quite las relaciones del elemento de trabajo.

Extensión GA
az boards work-item relation show

Obtener elemento de trabajo, rellenar las relaciones con el nombre descriptivo.

Extensión GA
az boards work-item show

Mostrar los detalles de un elemento de trabajo.

Extensión GA
az boards work-item update

Actualizar elementos de trabajo.

Extensión GA

az boards work-item create

Cree un elemento de trabajo.

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

Parámetros requeridos

--title

Título del elemento de trabajo.

--type

Nombre del tipo de elemento de trabajo (por ejemplo, Error).

Parámetros opcionales

--area

Área a la que se asigna el elemento de trabajo (por ejemplo, Demostraciones).

--assigned-to

Nombre de la persona a la que se asigna el elemento de trabajo (por ejemplo, fabrikam).

--description -d

Descripción del elemento de trabajo.

--detect

Detecta automáticamente la organización.

valores aceptados: false, true
--discussion

Comentario para agregar a una discusión en un elemento de trabajo.

--fields -f

Pares "field=value" separados por espacios para los campos personalizados que desea establecer. En el caso de varios campos: "field1=value1" "field2=value2". Consulte https://aka.ms/azure-devops-cli-field-api para obtener más información sobre los campos.

--iteration

Ruta de acceso de iteración del elemento de trabajo (por ejemplo, Demos\Iteración 1).

--open

Abra el elemento de trabajo en el explorador web predeterminado.

valor predeterminado: False
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o id. del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o se recoge a través de la configuración de Git.

--reason

Motivo del estado del elemento de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az boards work-item delete

Eliminar un elemento de trabajo.

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

Parámetros requeridos

--id

Identificador único del elemento de trabajo.

Parámetros opcionales

--destroy

Elimina definitivamente este elemento de trabajo.

valor predeterminado: False
--detect

Detecta automáticamente la organización.

valores aceptados: false, true
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o id. del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o se recoge a través de la configuración de Git.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az boards work-item show

Mostrar los detalles de un elemento de trabajo.

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

Parámetros requeridos

--id

El identificador del elemento de trabajo.

Parámetros opcionales

--as-of

Detalles del elemento de trabajo a partir de una fecha y hora concretas. Proporcione una cadena de fecha o fecha y hora. Asume la zona horaria local. Ejemplo: '2019-01-20', '2019-01-20 00:20:00'. Para UTC, anexe "UTC" a la cadena de fecha y hora, "2019-01-20 00:20:00 UTC".

--detect

Detecta automáticamente la organización.

valores aceptados: false, true
--expand

Parámetros expand para los atributos del elemento de trabajo.

valores aceptados: all, fields, links, none, relations
valor predeterminado: all
--fields -f

Lista separada por comas de campos solicitados. Ejemplo:System.Id,System.AreaPath. Consulte https://aka.ms/azure-devops-cli-field-api para obtener más información sobre los campos.

--open

Abra el elemento de trabajo en el explorador web predeterminado.

valor predeterminado: False
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Es obligatorio si no está configurada como predeterminada o seleccionada mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az boards work-item update

Actualizar elementos de trabajo.

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

Parámetros requeridos

--id

Identificador del elemento de trabajo que se va a actualizar.

Parámetros opcionales

--area

Área a la que se asigna el elemento de trabajo (por ejemplo, Demostraciones).

--assigned-to

Nombre de la persona a la que se asigna el elemento de trabajo (por ejemplo, fabrikam).

--description -d

Descripción del elemento de trabajo.

--detect

Detecta automáticamente la organización.

valores aceptados: false, true
--discussion

Comentario para agregar a una discusión en un elemento de trabajo.

--fields -f

Pares "field=value" separados por espacios para los campos personalizados que desea establecer. Consulte https://aka.ms/azure-devops-cli-field-api para obtener más información sobre los campos.

--iteration

Ruta de acceso de iteración del elemento de trabajo (por ejemplo, Demos\Iteración 1).

--open

Abra el elemento de trabajo en el explorador web predeterminado.

valor predeterminado: False
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Es obligatorio si no está configurada como predeterminada o seleccionada mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--reason

Motivo del estado del elemento de trabajo.

--state

Estado del elemento de trabajo (por ejemplo, activo).

--title

Título del elemento de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.