Compartir a través de

az boards work-item

Note

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.

Gestionar elementos de trabajo.

Comandos

Nombre Description Tipo Estado
az boards work-item create

Cree un elemento de trabajo.

 Extension GA
az boards work-item delete

Eliminar un elemento de trabajo.

 Extension GA
az boards work-item relation

Administrar las relaciones de elementos de trabajo.

 Extension GA
az boards work-item relation add

Agregue relaciones al elemento de trabajo.

 Extension GA
az boards work-item relation list-type

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

 Extension GA
az boards work-item relation remove

Quite las relaciones del elemento de trabajo.

 Extension GA
az boards work-item relation show

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

 Extension GA
az boards work-item show

Mostrar los detalles de un elemento de trabajo.

 Extension GA
az boards work-item update

Actualizar elementos de trabajo.

 Extension 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 --organization]
                           [--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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Detectar automáticamente la organización.

Propiedad Valor
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

Abre el elemento de trabajo en el explorador web predeterminado.

Propiedad Valor
Valor predeterminado: False
--org --organization

Dirección 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 a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado 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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az boards work-item delete

Eliminar un elemento de trabajo.

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

Parámetros requeridos

--id

Identificador único del elemento de trabajo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--destroy

Elimina definitivamente este elemento de trabajo.

Propiedad Valor
Valor predeterminado: False
--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--org --organization

Dirección 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 a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

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

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --organization]

Parámetros requeridos

--id

El identificador del elemento de trabajo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--expand

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

Propiedad Valor
Valor predeterminado: all
Valores aceptados: all, fields, links, none, relations
--fields -f

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

--open

Abre el elemento de trabajo en el explorador web predeterminado.

Propiedad Valor
Valor predeterminado: False
--org --organization

Dirección 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 a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

Parámetros requeridos

--id

Identificador del elemento de trabajo que se va a actualizar.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Detectar automáticamente la organización.

Propiedad Valor
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

Abre el elemento de trabajo en el explorador web predeterminado.

Propiedad Valor
Valor predeterminado: False
--org --organization

Dirección 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 a través de 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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False