Compartilhar via


az boards work-item

Note

Essa referência faz parte da extensão azure-devops para a CLI do Azure (versão 2.30.0 ou superior). A extensão instalará automaticamente a primeira vez que você executar um comando az boards work-item. Saiba mais sobre extensões.

Gerenciar itens de trabalho.

Comandos

Nome Description Tipo Status
az boards work-item create

Crie um item de trabalho.

Extension GA
az boards work-item delete

Excluir um item de trabalho.

Extension GA
az boards work-item relation

Gerenciar relações de item de trabalho.

Extension GA
az boards work-item relation add

Adicione relação ao item de trabalho.

Extension GA
az boards work-item relation list-type

Listar relações de item de trabalho com suporte na organização.

Extension GA
az boards work-item relation remove

Remova a(s) relação(s) do item de trabalho.

Extension GA
az boards work-item relation show

Obtenha o item de trabalho, preencha as relações com o nome amigável.

Extension GA
az boards work-item show

Mostrar detalhes de um item de trabalho.

Extension GA
az boards work-item update

Atualizar itens de trabalho.

Extension GA

az boards work-item create

Crie um item de trabalho.

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

Parâmetros Exigidos

--title

Título do item de trabalho.

--type

Nome do tipo de item de trabalho (por exemplo, Bug).

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--area

Área à qual o item de trabalho é atribuído (por exemplo, Demonstrações).

--assigned-to

Nome da pessoa à qual o item de trabalho está atribuído (por exemplo, fabrikam).

--description -d

Descrição do item de trabalho.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--discussion

Comente para adicionar a uma discussão em um item de trabalho.

--fields -f

Pares "field=value" separados por espaço para campos personalizados que você gostaria de definir. No caso de vários campos: "field1=value1" "field2=value2". Consulte https://aka.ms/azure-devops-cli-field-api para obter mais detalhes sobre campos.

--iteration

Caminho de iteração do item de trabalho (por exemplo, Demos\Iteração 1).

--open

Abra o item de trabalho no navegador da Web padrão.

Propriedade Valor
Valor padrão: False
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração Git.

--reason

Motivo para o estado do item de trabalho.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az boards work-item delete

Excluir um item de trabalho.

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

Parâmetros Exigidos

--id

ID exclusiva do item de trabalho.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--destroy

Exclui permanentemente este item de trabalho.

Propriedade Valor
Valor padrão: False
--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração Git.

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az boards work-item show

Mostrar detalhes de um item de trabalho.

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

Parâmetros Exigidos

--id

A ID do item de trabalho.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--as-of

Detalhes do item de trabalho a partir de uma data e hora específicas. Forneça uma cadeia de caracteres de data ou data/hora. Pressupõe fuso horário local. Exemplo: '2019-01-20', '2019-01-20 00:20:00'. Para UTC, acrescente 'UTC' à cadeia de caracteres de data/hora, '2019-01-20 00:20:00 UTC'.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--expand

Os parâmetros de expansão para atributos de item de trabalho.

Propriedade Valor
Valor padrão: all
Valores aceitos: all, fields, links, none, relations
--fields -f

Lista separada por vírgulas de campos solicitados. Example:System.Id,System.AreaPath. Consulte https://aka.ms/azure-devops-cli-field-api para obter mais detalhes sobre campos.

--open

Abra o item de trabalho no navegador da Web padrão.

Propriedade Valor
Valor padrão: False
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az boards work-item update

Atualizar itens de trabalho.

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

Parâmetros Exigidos

--id

A ID do item de trabalho a ser atualizado.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--area

Área à qual o item de trabalho é atribuído (por exemplo, Demonstrações).

--assigned-to

Nome da pessoa à qual o item de trabalho está atribuído (por exemplo, fabrikam).

--description -d

Descrição do item de trabalho.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--discussion

Comente para adicionar a uma discussão em um item de trabalho.

--fields -f

Pares "field=value" separados por espaço para campos personalizados que você gostaria de definir. Consulte https://aka.ms/azure-devops-cli-field-api para obter mais detalhes sobre campos.

--iteration

Caminho de iteração do item de trabalho (por exemplo, Demos\Iteração 1).

--open

Abra o item de trabalho no navegador da Web padrão.

Propriedade Valor
Valor padrão: False
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

--reason

Motivo para o estado do item de trabalho.

--state

Estado do item de trabalho (por exemplo, ativo).

--title

Título do item de trabalho.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False