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

New-AzAutomationSoftwareUpdateConfiguration

模块:: Az.Automation Module

创建计划的 Azure 自动化软件更新配置。

语法

Windows (默认值)

New-AzAutomationSoftwareUpdateConfiguration
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -Schedule <Schedule>
    [-Windows]
    [-RebootOnly]
    [-AzureVMResourceId <String[]>]
    [-PreTaskRunbookName <String>]
    [-PostTaskRunbookName <String>]
    [-PreTaskRunbookParameter <Hashtable>]
    [-PostTaskRunbookParameter <Hashtable>]
    [-NonAzureComputer <String[]>]
    [-AzureQuery <AzureQueryProperties[]>]
    [-NonAzureQuery <NonAzureQueryProperties[]>]
    [-Duration <TimeSpan>]
    [-RebootSetting <RebootSetting>]
    [-IncludedUpdateClassification <WindowsUpdateClasses[]>]
    [-ExcludedKbNumber <String[]>]
    [-IncludedKbNumber <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Linux

New-AzAutomationSoftwareUpdateConfiguration
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -Schedule <Schedule>
    [-Linux]
    [-RebootOnly]
    [-AzureVMResourceId <String[]>]
    [-PreTaskRunbookName <String>]
    [-PostTaskRunbookName <String>]
    [-PreTaskRunbookParameter <Hashtable>]
    [-PostTaskRunbookParameter <Hashtable>]
    [-NonAzureComputer <String[]>]
    [-AzureQuery <AzureQueryProperties[]>]
    [-NonAzureQuery <NonAzureQueryProperties[]>]
    [-Duration <TimeSpan>]
    [-RebootSetting <RebootSetting>]
    [-IncludedPackageClassification <LinuxPackageClasses[]>]
    [-ExcludedPackageNameMask <String[]>]
    [-IncludedPackageNameMask <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

创建按计划运行的软件更新配置，以更新计算机列表。计算机包括 Azure 虚拟机或非 az 计算机。

示例

示例 1

创建一个软件更新配置，用于在两个 Windows Azure 虚拟机上安装关键更新，每个星期六晚上 9 点一次。在此示例中，更新持续时间设置为 2 小时。

$startTime = [DateTimeOffset]"2018-09-13T21:00"
$targetMachines = @(
    "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/vm-w-01",
    "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/vm-w-02"
)
$duration = New-TimeSpan -Hours 2
$schedule = New-AzAutomationSchedule -ResourceGroupName "mygroup" `
                                                  -AutomationAccountName "myaccount" `
                                                  -Name MyWeeklySchedule `
                                                  -StartTime $startTime `
                                                  -DaysOfWeek Saturday `
                                                  -WeekInterval 1 `
                                                  -ForUpdateConfiguration

New-AzAutomationSoftwareUpdateConfiguration -ResourceGroupName "mygroup" `
                                                 -AutomationAccountName "myaccount" `
                                                 -Schedule $schedule `
                                                 -Windows `
                                                 -AzureVMResourceId $targetMachines `
                                                 -IncludedUpdateClassification Critical `
                                                 -Duration $duration

UpdateConfiguration   : Microsoft.Azure.Commands.Automation.Model.UpdateManagement.UpdateConfiguration
ScheduleConfiguration : Microsoft.Azure.Commands.Automation.Model.Schedule
ProvisioningState     : Provisioning
ErrorInfo             :
ResourceGroupName     : mygroup
AutomationAccountName : myaccount
Name                  : MyWeeklySchedule
CreationTime          : 9/14/2018 3:53:27 AM +00:00
LastModifiedTime      : 9/14/2018 3:53:27 AM +00:00
Description           :

参数

-AutomationAccountName

自动化帐户名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-AzureQuery

动态组 Azure 查询。

参数属性

类型:	AzureQueryProperties[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-AzureVMResourceId

Azure 虚拟机的资源 ID。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Duration

更新的最大持续时间。

参数属性

类型:	TimeSpan
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ExcludedKbNumber

排除的更新的 KB 数。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

Windows

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ExcludedPackageNameMask

排除的 Linux 包掩码。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

Linux

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-IncludedKbNumber

包含的更新的 KB 数。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

Windows

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-IncludedPackageClassification

包含的 Linux 包分类。

参数属性

类型:	LinuxPackageClasses[]
默认值:	None
接受的值:	Unclassified, Critical, Security, Other
支持通配符:	False
不显示:	False

参数集

Linux

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-IncludedPackageNameMask

包含的 Linux 包掩码。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

Linux

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-IncludedUpdateClassification

包含的 Windows 更新分类。

参数属性

类型:	WindowsUpdateClasses[]
默认值:	None
接受的值:	Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates
支持通配符:	False
不显示:	False

参数集

Windows

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Linux

指示面向 Linux作系统计算机的软件更新配置。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

Linux

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-NonAzureComputer

非 Az 计算机名称。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-NonAzureQuery

动态组非 Azure 查询。

参数属性

类型:	NonAzureQueryProperties[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-PostTaskRunbookName

发布任务。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-PostTaskRunbookParameter

Post 任务参数。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-PreTaskRunbookName

任务前。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-PreTaskRunbookParameter

任务前参数。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-RebootOnly

指示软件更新配置将仅重启计算机。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-RebootSetting

重新启动设置。

参数属性

类型:	RebootSetting
默认值:	None
接受的值:	IfRequired, Never, Always, RebootOnly
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ResourceGroupName

资源组名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Schedule

用于软件更新配置的 Schedule 对象。

参数属性

类型:	Schedule
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Windows

指示面向 Windows作系统计算机的软件更新配置。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

Windows

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

New-AzAutomationSoftwareUpdateConfiguration

语法

Windows (默认值)

Linux

说明

示例

示例 1

参数

-AutomationAccountName

参数属性

参数集

-AzureQuery

参数属性

参数集

-AzureVMResourceId

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-Duration

参数属性

参数集

-ExcludedKbNumber

参数属性

参数集

-ExcludedPackageNameMask

参数属性

参数集

-IncludedKbNumber

参数属性

参数集

-IncludedPackageClassification

参数属性

参数集

-IncludedPackageNameMask

参数属性

参数集

-IncludedUpdateClassification

参数属性

参数集

-Linux

参数属性

参数集

-NonAzureComputer

参数属性

参数集

-NonAzureQuery

参数属性

参数集

-PostTaskRunbookName

参数属性

参数集

-PostTaskRunbookParameter

参数属性

参数集

-PreTaskRunbookName

参数属性

参数集

-PreTaskRunbookParameter

参数属性

参数集

-RebootOnly

参数属性

参数集

-RebootSetting

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-Schedule

参数属性

参数集

-WhatIf

参数属性