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

New-AzAutomationSoftwareUpdateConfiguration

参考

模块:: Az.Automation

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

语法

New-AzAutomationSoftwareUpdateConfiguration
   -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[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAutomationSoftwareUpdateConfiguration
   -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[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <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
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-AzureQuery

动态组 Azure 查询。

类型:	AzureQueryProperties[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-AzureVMResourceId

Azure 虚拟机的资源 ID。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

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

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Duration

更新的最大持续时间。

类型:	TimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ExcludedKbNumber

排除的更新的 KB 数。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ExcludedPackageNameMask

排除的 Linux 包掩码。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-IncludedKbNumber

包含的更新的 KB 数。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-IncludedPackageClassification

包含的 Linux 包分类。

类型:	LinuxPackageClasses[]
接受的值:	Unclassified, Critical, Security, Other
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-IncludedPackageNameMask

包含的 Linux 包掩码。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-IncludedUpdateClassification

包含Windows 更新分类。

类型:	WindowsUpdateClasses[]
接受的值:	Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Linux

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-NonAzureComputer

非 Az 计算机名称。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-NonAzureQuery

动态组非 Azure 查询。

类型:	NonAzureQueryProperties[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-PostTaskRunbookName

发布任务。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-PostTaskRunbookParameter

Post 任务参数。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-PreTaskRunbookName

任务前。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-PreTaskRunbookParameter

任务前参数。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-RebootOnly

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-RebootSetting

重新启动设置。

类型:	RebootSetting
接受的值:	IfRequired, Never, Always, RebootOnly
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ResourceGroupName

资源组名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Schedule

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

类型:	Schedule
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Windows

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

Schedule

SwitchParameter

String[]

TimeSpan

WindowsUpdateClasses[]

LinuxPackageClasses[]

String

输出

SoftwareUpdateConfiguration

通过