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

New-AzureRmAutomationSoftwareUpdateConfiguration

参考

模块:: AzureRM.Automation

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

警告

AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可运行，但不再受到维护或支持，任何继续使用的行为都由用户自行决定并自行承担风险。有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

New-AzureRmAutomationSoftwareUpdateConfiguration
   -Schedule <Schedule>
   [-Windows]
   [-AzureVMResourceId <String[]>]
   [-NonAzureComputer <String[]>]
   [-Duration <TimeSpan>]
   [-IncludedUpdateClassification <WindowsUpdateClasses[]>]
   [-ExcludedKbNumber <String[]>]
   [-IncludedKbNumber <String[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmAutomationSoftwareUpdateConfiguration
   -Schedule <Schedule>
   [-Linux]
   [-AzureVMResourceId <String[]>]
   [-NonAzureComputer <String[]>]
   [-Duration <TimeSpan>]
   [-IncludedPackageClassification <LinuxPackageClasses[]>]
   [-ExcludedPackageNameMask <String[]>]
   [-IncludedPackageNameMask <String[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

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

示例

示例 1

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

PS C:\> $startTime = [DateTimeOffset]"2018-09-13T21:00"
PS C:\> $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"
    )
PS C:\> $duration = New-TimeSpan -Hours 2
PS C:\> $schedule = New-AzureRmAutomationSchedule -ResourceGroupName "mygroup" `
                                                  -AutomationAccountName "myaccount" `
                                                  -Name MyWeeklySchedule `
                                                  -StartTime $startTime `
                                                  -DaysOfWeek Saturday `
                                                  -WeekInterval 1 `
                                                  -ForUpdateConfiguration

New-AzureRmAutomationSoftwareUpdateConfiguration -ResourceGroupName "mygroup" `
                                                 -AutomationAccountName "myaccount" `
                                                 -Schedule $schedule `
                                                 -Windows `
                                                 -AzureVMResourceIds $targetMachines `
                                                 -IncludedUpdateClassifications 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

-AzureVMResourceId

Azure 虚拟机的资源 ID。

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

-Confirm

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

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

-DefaultProfile

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

类型:	IAzureContextContainer
别名:	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

非 Azure 计算机名称。

类型:	String[]
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

通过