Partilhar via

az boards work-item

Note

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

Gerenciar itens de trabalho.

Comandos

Name Description Tipo Status
az boards work-item create

Crie um item de trabalho.

 Extension disponibilidade geral
az boards work-item delete

Excluir um item de trabalho.

 Extension disponibilidade geral
az boards work-item relation

Gerenciar relações de item de trabalho.

 Extension disponibilidade geral
az boards work-item relation add

Adicione relação(ões) ao item de trabalho.

 Extension disponibilidade geral
az boards work-item relation list-type

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

 Extension disponibilidade geral
az boards work-item relation remove

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

 Extension disponibilidade geral
az boards work-item relation show

Obter item de trabalho, preencher relações com nome amigável.

 Extension disponibilidade geral
az boards work-item show

Mostrar detalhes de um item de trabalho.

 Extension disponibilidade geral
az boards work-item update

Atualizar itens de trabalho.

 Extension disponibilidade geral

az boards work-item create

Crie um item de trabalho.

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

Parâmetros Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--area

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

--assigned-to

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

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--description -d

Descrição do item de trabalho.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--discussion

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

--fields -f

Pares "campo=valor" 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 os campos.

--iteration

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

--open

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

Propriedade Valor
Default value: False
--org --organization

Azure DevOps organization URL. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. 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. Necessário se não configurado como padrão ou captado via git config.

--reason

Motivo do estado do item de trabalho.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az boards work-item delete

Excluir um item de trabalho.

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

Parâmetros Obrigatórios

--id

ID exclusivo do item de trabalho.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--destroy

Exclua permanentemente este item de trabalho.

Propriedade Valor
Default value: False
--detect

Detete automaticamente a organização.

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

Azure DevOps organization URL. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. 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. Necessário se não configurado como padrão ou captado via git config.

--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--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 hora. Assume o 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

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--expand

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

Propriedade Valor
Default value: all
Valores aceites: all, fields, links, none, relations
--fields -f

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

--open

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

Propriedade Valor
Default value: False
--org --organization

Azure DevOps organization URL. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az boards work-item update

Atualizar itens de trabalho.

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

Parâmetros Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--area

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

--assigned-to

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

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--description -d

Descrição do item de trabalho.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--discussion

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

--fields -f

Pares "campo=valor" 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 os campos.

--iteration

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

--open

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

Propriedade Valor
Default value: False
--org --organization

Azure DevOps organization URL. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--reason

Motivo do estado do item de trabalho.

--state

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

--title

Título do item de trabalho.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False