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
Título do item de trabalho.
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.
Área à qual o item de trabalho é atribuído (por exemplo, Demonstrações).
Nome da pessoa à qual o item de trabalho está atribuído (por exemplo, fabrikam).
Descrição do item de trabalho.
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Comente para adicionar a uma discussão em um item de trabalho.
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.
Caminho de iteração do item de trabalho (por exemplo, Demos\Iteração 1).
Abra o item de trabalho no navegador da Web padrão.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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/.
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.
Motivo para o estado do item de trabalho.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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 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.
Exclui permanentemente este item de trabalho.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
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/.
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.
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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.
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'.
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
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 |
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.
Abra o item de trabalho no navegador da Web padrão.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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.
Área à qual o item de trabalho é atribuído (por exemplo, Demonstrações).
Nome da pessoa à qual o item de trabalho está atribuído (por exemplo, fabrikam).
Descrição do item de trabalho.
Detecte automaticamente a organização.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Comente para adicionar a uma discussão em um item de trabalho.
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.
Caminho de iteração do item de trabalho (por exemplo, Demos\Iteração 1).
Abra o item de trabalho no navegador da Web padrão.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
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/.
Motivo para o estado do item de trabalho.
Estado do item de trabalho (por exemplo, ativo).
Título do item de trabalho.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |