az automation source-control

参考

注释

此参考是 Azure CLI（版本 2.55.0 或更高版本）自动化 扩展的一部分。该扩展会在首次运行 az automation source-control 命令时自动安装。了解更多关于扩展的相关信息。

管理源代码管理。

命令

名称	说明	类型	Status
az automation source-control create	创建源代码管理。	扩展	GA
az automation source-control delete	删除源代码管理。	扩展	GA
az automation source-control list	列出源代码管理列表。	扩展	GA
az automation source-control show	获取由源代码管理名称标识的源代码管理。	扩展	GA
az automation source-control sync-job	管理源代码管理同步作业。	扩展	GA
az automation source-control sync-job create	为源代码管理创建同步作业。	扩展	GA
az automation source-control sync-job list	列出源代码管理同步作业的列表。	扩展	GA
az automation source-control sync-job show	获取由作业 ID 标识的源代码管理同步作业。	扩展	GA
az automation source-control sync-job stream	管理同步作业流。	扩展	GA
az automation source-control sync-job stream list	列出由同步作业 ID 标识的同步作业流的列表。	扩展	GA
az automation source-control sync-job stream show	获取由流 ID 标识的同步作业流。	扩展	GA
az automation source-control sync-job update	更新源代码管理的同步作业。	扩展	GA
az automation source-control update	更新源代码管理。	扩展	GA

az automation source-control create

创建源代码管理。

az automation source-control create --account --automation-account-name
                                    --name --source-control-name
                                    --resource-group
                                    [--access-token]
                                    [--auto-sync {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--branch]
                                    [--description]
                                    [--folder-path]
                                    [--publish-runbook {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--refresh-token]
                                    [--repo-url]
                                    [--source-type {GitHub, VsoGit, VsoTfvc}]
                                    [--token-type {Oauth, PersonalAccessToken}]

示例

创建源代码管理

az automation source-control create -g rg --automation-account-name myAutomationAccount --name source-control --repo-url https://github.com/myAccount/myRepo.git --branch master --source-type GitHub --folder-path / --access-token ghp_MOCKED_GITHUB_TOKEN --token-type PersonalAccessToken --publish-runbook false

必需参数

--account --automation-account-name

自动化帐户的名称。

--name --source-control-name -n

源代码管理名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

--access-token

访问令牌。

--auto-sync

源代码管理自动同步。默认值为 false。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--branch

源代码管理的存储库分支。将分支作为 VsoTfvc 的空字符串包含在内。

--description

源代码管理的用户说明。

--folder-path

源代码管理的文件夹路径。路径必须是相对路径。

--publish-runbook

源代码管理自动发布。默认值为 true。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--refresh-token

刷新令牌。

--repo-url

源代码管理的存储库 URL。

--source-type

源类型。必须是 VsoGit、VsoTfvc、GitHub、区分大小写的 VsoGit 之一。

接受的值: GitHub, VsoGit, VsoTfvc

--token-type

标记类型。必须是 PersonalAccessToken 或 Oauth。

接受的值: Oauth, PersonalAccessToken

全局参数

--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 automation source-control delete

删除源代码管理。

az automation source-control delete [--account --automation-account-name]
                                    [--ids]
                                    [--name --source-control-name]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

示例

删除源代码管理

az automation source-control delete -g rg --automation-account-name myAutomationAccount --name sourceControl -y

可选参数

--account --automation-account-name

自动化帐户的名称。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--name --source-control-name -n

源代码管理的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

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

--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 automation source-control list

列出源代码管理列表。

az automation source-control list --account --automation-account-name
                                  --resource-group
                                  [--filter]
                                  [--max-items]
                                  [--next-token]

示例

列出源代码管理

az automation source-control list -g rg --automation-account-name myAutomationAccount

必需参数

--account --automation-account-name

自动化帐户的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

可选参数

--filter

要应用于作的筛选器。

--max-items

命令输出中要返回的项总数。如果可用的项总数大于指定的值，则会在命令的输出中提供令牌。若要恢复分页，请在后续命令的 --next-token 参数中提供令牌值。

--next-token

用于指定开始分页的位置的令牌。这是先前截断的响应中的令牌值。

全局参数

--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 automation source-control show

获取由源代码管理名称标识的源代码管理。

az automation source-control show [--account --automation-account-name]
                                  [--ids]
                                  [--name --source-control-name]
                                  [--resource-group]
                                  [--subscription]

示例

获取有关源代码管理的信息

az automation source-control show -g rg --automation-account-name myAutomationAccount --name sourceControl

可选参数

--account --automation-account-name

自动化帐户的名称。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--name --source-control-name -n

源代码管理的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

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

全局参数

--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 automation source-control update

更新源代码管理。

az automation source-control update [--access-token]
                                    [--account --automation-account-name]
                                    [--add]
                                    [--auto-sync {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--branch]
                                    [--description]
                                    [--folder-path]
                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--ids]
                                    [--name --source-control-name]
                                    [--publish-runbook {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--refresh-token]
                                    [--remove]
                                    [--repo-url]
                                    [--resource-group]
                                    [--set]
                                    [--source-type {GitHub, VsoGit, VsoTfvc}]
                                    [--subscription]
                                    [--token-type {Oauth, PersonalAccessToken}]

示例

更新源代码管理属性

az automation source-control update -g rg --automation-account-name myAutomationAccount --name sourceControl --access-token ghp_GITHUB_TOKEN --token-type PersonalAccessToken --publish-runbook True

可选参数

--access-token

访问令牌。

--account --automation-account-name

自动化帐户的名称。

--add

通过指定路径和键值对将对象添加到对象列表。示例：--add property.listProperty <key=value, string or JSON string>。

--auto-sync

源代码管理自动同步。默认值为 false。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--branch

源代码管理的存储库分支。将分支作为 VsoTfvc 的空字符串包含在内。

--description

源代码管理的用户说明。

--folder-path

源代码管理的文件夹路径。路径必须是相对路径。

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--name --source-control-name -n

源代码管理的名称。

--publish-runbook

源代码管理自动发布。默认值为 true。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--refresh-token

刷新令牌。

--remove

从列表中删除属性或元素。示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

--repo-url

源代码管理的存储库 URL。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--set

通过指定要设置的属性路径和值来更新对象。示例：--set property1.property2=<value>。

--source-type

源类型。必须是 VsoGit、VsoTfvc、GitHub、区分大小写的 VsoGit 之一。

接受的值: GitHub, VsoGit, VsoTfvc

--subscription

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

--token-type

标记类型。必须是 PersonalAccessToken 或 Oauth。

接受的值: Oauth, PersonalAccessToken

全局参数

--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 获取完整的调试日志。