你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az boards iteration project

注意

此参考是 Azure CLI（版本 2.30.0 或更高版本）的 azure-devops 扩展的一部分。 该扩展将在首次运行 az boards 迭代项目 命令时自动安装。 详细了解扩展。

管理项目的迭代。

命令

名称	说明	类型	状态
az boards iteration project create	创建迭代。	分机	GA
az boards iteration project delete	删除迭代。	扩展	GA
az boards iteration project list	列出项目的迭代。	扩展	GA
az boards iteration project show	显示项目的迭代详细信息。	扩展	GA
az boards iteration project update	更新项目迭代。	分机	GA

az boards iteration project create

创建迭代。

az boards iteration project create --name
                                   [--detect {false, true}]
                                   [--finish-date]
                                   [--org]
                                   [--path]
                                   [--project]
                                   [--start-date]

必需参数

--name

迭代的名称。

可选参数

--detect

自动检测组织。

接受的值: false, true

--finish-date

完成迭代的日期。 示例：“2019-06-21”。

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--path

迭代的绝对路径。 如果未指定 --path，请在根级别创建迭代。 示例：\ProjectName\Iteration\IterationName。

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

--start-date

迭代的开始日期。 示例：“2019-06-03”。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az boards iteration project delete

删除迭代。

az boards iteration project delete --path
                                   [--detect {false, true}]
                                   [--org]
                                   [--project]
                                   [--yes]

必需参数

--path

迭代的绝对路径。 示例：\ProjectName\Iteration\IterationName。

可选参数

--detect

自动检测组织。

接受的值: false, true

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

--yes -y

不提示确认。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az boards iteration project list

列出项目的迭代。

az boards iteration project list [--depth]
                                 [--detect {false, true}]
                                 [--org]
                                 [--path]
                                 [--project]

可选参数

--depth

要提取的子节点的深度。 示例：--depth 3。

默认值: 1

--detect

自动检测组织。

接受的值: false, true

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--path

迭代的绝对路径。 示例：\ProjectName\Iteration\IterationName。

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az boards iteration project show

显示项目的迭代详细信息。

az boards iteration project show --id
                                 [--detect {false, true}]
                                 [--org]
                                 [--project]

必需参数

--id

迭代 ID。

可选参数

--detect

自动检测组织。

接受的值: false, true

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az boards iteration project update

更新项目迭代。

移动迭代或更新迭代详细信息，例如名称 AND/OR 开始日期和完成日期。

az boards iteration project update --path
                                   [--child-id]
                                   [--detect {false, true}]
                                   [--finish-date]
                                   [--name]
                                   [--org]
                                   [--project]
                                   [--start-date]

必需参数

--path

迭代的绝对路径。 示例：\ProjectName\Iteration\IterationName。

可选参数

--child-id

移动现有迭代，并将其添加为此迭代的子节点。

--detect

自动检测组织。

接受的值: false, true

--finish-date

完成迭代的日期。 示例：“2019-06-21”。

--name

迭代的新名称。

--org --organization

Azure DevOps 组织 URL。 可以使用 az devops configure -d organization=ORG_URL 配置默认组织。 如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--project -p

项目的名称或 ID。 可以使用 az devops configure -d project=NAME_OR_ID 配置默认项目。 如果未配置为默认或通过 git 配置进行选取，则为必需。

--start-date

迭代的开始日期。 示例：“2019-06-03”。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。