az automation software-update-configuration

注释

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

自动化软件更新配置。

命令

名称 说明 类型 Status
az automation software-update-configuration create

创建自动化软件更新配置。

扩展 GA
az automation software-update-configuration delete

删除自动化软件更新配置。

扩展 GA
az automation software-update-configuration list

列出帐户的所有软件更新配置。

扩展 GA
az automation software-update-configuration machine-runs

软件更新配置计算机运行。

扩展 GA
az automation software-update-configuration machine-runs list

列出软件更新配置计算机运行。

扩展 GA
az automation software-update-configuration machine-runs show

按 ID 获取单个软件更新配置计算机运行。

扩展 GA
az automation software-update-configuration runs

软件更新配置运行。

扩展 GA
az automation software-update-configuration runs list

返回软件更新配置运行的列表。

扩展 GA
az automation software-update-configuration runs show

按 ID 获取单个软件更新配置运行。

扩展 GA
az automation software-update-configuration show

按名称获取单个软件更新配置。

扩展 GA

az automation software-update-configuration create

创建自动化软件更新配置。

az automation software-update-configuration create --automation-account-name
                                                   --configuration-name --name
                                                   --frequency
                                                   --interval
                                                   --operating-system {Linux, Windows}
                                                   --resource-group
                                                   [--azure-queries-locations]
                                                   [--azure-queries-scope]
                                                   [--azure-queries-tags]
                                                   [--azure-virtual-machines]
                                                   [--creation-time]
                                                   [--description]
                                                   [--duration]
                                                   [--excluded-kb-numbers]
                                                   [--expiry-time]
                                                   [--expiry-time-offset-minutes]
                                                   [--included-kb-numbers]
                                                   [--included-update-classifications]
                                                   [--is-enabled {false, true}]
                                                   [--last-modified-time]
                                                   [--next-run]
                                                   [--next-run-offset-minutes]
                                                   [--non-azure-computer-names]
                                                   [--non-azure-queries-function-alias]
                                                   [--non-azure-queries-workspace-id]
                                                   [--post-task-job-id]
                                                   [--post-task-source]
                                                   [--post-task-status]
                                                   [--pre-task-job-id]
                                                   [--pre-task-source]
                                                   [--pre-task-status]
                                                   [--reboot-setting]
                                                   [--start-time]
                                                   [--time-zone]

示例

创建自动化 software-update-configuration

az automation software-update-configuration create --automation-account-name "myAutomationAccount"                  --resource-group "rg" -n mySoftwareUpdateConfiguration --frequency Hour --interval 1                  --operating-system windows --excluded-kb-numbers 16800,16800 -n confgname                  --included-update-classifications Critical --duration pT2H0M --azure-virtual-machines                  /subscriptions/{subid}/resourceGroups/{rg}/providers/Microsoft.Compute/virtualMachines/myVM

必需参数

--automation-account-name

自动化帐户的名称。

--configuration-name --name -n

软件更新配置的名称。

--frequency

计划的频率。

--interval

计划的间隔。

--operating-system

目标计算机的作系统。

接受的值: Linux, Windows
--resource-group -g

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

可选参数

--azure-queries-locations

软件更新配置中 Azure 查询位置的空间分隔列表。

--azure-queries-scope

软件更新配置中 Azure 查询范围的空间分隔列表。

--azure-queries-tags

软件更新配置中 Azure 查询标记设置的空间分隔列表。

--azure-virtual-machines

针对软件更新配置的 Azure 虚拟机的 Azure 资源 ID 的空间分隔列表。

--creation-time

创建时间。 格式:date(yyyy-mm-dd) time (hh:mm:ss.xxxxx) 时区 (+/-hh:mm)。

--description

计划的说明。

--duration

软件更新配置运行允许的最大时间。 需要根据ISO8601使用 PT[n]H[n]M[n]S 格式指定持续时间。

--excluded-kb-numbers

从软件更新配置中排除的 KB 编号的空间分隔列表。

--expiry-time

计划的结束时间。 格式:date(yyyy-mm-dd) time (hh:mm:ss.xxxxx) 时区 (+/-hh:mm)。

--expiry-time-offset-minutes

到期时间的偏移量(以分钟为单位)。

--included-kb-numbers

软件更新配置中包含的空格分隔的 KB 编号列表。

--included-update-classifications

软件更新配置中包含的更新分类。 带所需值的逗号分隔字符串。

--is-enabled

指示是否启用此计划。

接受的值: false, true
--last-modified-time

上次修改时间。 格式:date(yyyy-mm-dd) time (hh:mm:ss.xxxxx) 时区 (+/-hh:mm)。

--next-run

计划的下一个运行时。 格式:date(yyyy-mm-dd) time (hh:mm:ss.xxxxx) 时区 (+/-hh:mm)。

--next-run-offset-minutes

下一个运行时的偏移量(以分钟为单位)。

--non-azure-computer-names

以空格分隔的非 Azure 计算机的名称列表,以软件更新配置为目标。

--non-azure-queries-function-alias

Log Analytics 保存的搜索名称。

--non-azure-queries-workspace-id

Log Analytics 的工作区 ID。

--post-task-job-id

任务的作业 ID。

--post-task-source

任务源的名称。

--post-task-status

任务的状态。

--pre-task-job-id

任务的作业 ID。

--pre-task-source

任务源的名称。

--pre-task-status

任务的状态。

--reboot-setting

软件更新配置的重新启动设置。

--start-time

计划的开始时间。 格式:date(yyyy-mm-dd) time (hh:mm:ss.xxxxx) 时区 (+/-hh:mm)。

--time-zone

计划的时区。

全局参数
--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 software-update-configuration delete

删除自动化软件更新配置。

az automation software-update-configuration delete --automation-account-name
                                                   --configuration-name --name
                                                   --resource-group
                                                   [--yes]

示例

删除自动化 software-update-configuration

az automation software-update-configuration delete --name "mySoftwareUpdateConfiguration"                --resource-group "rg" --automation-account-name "myAutomationAccount"

必需参数

--automation-account-name

自动化帐户的名称。

--configuration-name --name -n

软件更新配置的名称。

--resource-group -g

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

可选参数

--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 software-update-configuration list

列出帐户的所有软件更新配置。

az automation software-update-configuration list --automation-account-name
                                                 --resource-group

示例

按自动化帐户列出软件更新配置

az automation software-update-configuration list --automation-account-name "myAutomationAccount"                 --resource-group "rg"

必需参数

--automation-account-name

自动化帐户的名称。

--resource-group -g

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

全局参数
--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 software-update-configuration show

按名称获取单个软件更新配置。

az automation software-update-configuration show --automation-account-name
                                                 --configuration-name --name
                                                 --resource-group

示例

获取 software-update-configuration

az automation software-update-configuration show --automation-account-name "myAutomationAccount"                --resource-group "rg" --name "mySoftwareUpdateConfiguration"

必需参数

--automation-account-name

自动化帐户的名称。

--configuration-name --name -n

软件更新配置的名称。

--resource-group -g

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

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