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

Install-AzConnectedMachinePatch

在 Azure 中的混合计算机标识上安装修补程序的作。

语法

InstallExpanded (默认值)

Install-AzConnectedMachinePatch
    -Name <String>
    -ResourceGroupName <String>
    -MaximumDuration <String>
    -RebootSetting <String>
    [-SubscriptionId <String>]
    [-LinuxParameterClassificationsToInclude <String[]>]
    [-LinuxParameterPackageNameMasksToExclude <String[]>]
    [-LinuxParameterPackageNameMasksToInclude <String[]>]
    [-WindowParameterClassificationsToInclude <String[]>]
    [-WindowParameterExcludeKbsRequiringReboot]
    [-WindowParameterKbNumbersToExclude <String[]>]
    [-WindowParameterKbNumbersToInclude <String[]>]
    [-WindowParameterMaxPatchPublishDate <DateTime>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstallViaJsonString

Install-AzConnectedMachinePatch
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstallViaJsonFilePath

Install-AzConnectedMachinePatch
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Install

Install-AzConnectedMachinePatch
    -Name <String>
    -ResourceGroupName <String>
    -InstallPatchesInput <IMachineInstallPatchesParameters>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstallViaIdentityExpanded

Install-AzConnectedMachinePatch
    -InputObject <IConnectedMachineIdentity>
    -MaximumDuration <String>
    -RebootSetting <String>
    [-LinuxParameterClassificationsToInclude <String[]>]
    [-LinuxParameterPackageNameMasksToExclude <String[]>]
    [-LinuxParameterPackageNameMasksToInclude <String[]>]
    [-WindowParameterClassificationsToInclude <String[]>]
    [-WindowParameterExcludeKbsRequiringReboot]
    [-WindowParameterKbNumbersToExclude <String[]>]
    [-WindowParameterKbNumbersToInclude <String[]>]
    [-WindowParameterMaxPatchPublishDate <DateTime>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstallViaIdentity

Install-AzConnectedMachinePatch
    -InputObject <IConnectedMachineIdentity>
    -InstallPatchesInput <IMachineInstallPatchesParameters>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

在 Azure 中的混合计算机标识上安装修补程序的作。

示例

示例 1:安装评估修补程序

Install-AzConnectedMachinePatch -ResourceGroupName az-sdk-test -Name testMachine -MaximumDuration 'PT4H' -RebootSetting 'IfRequired' -WindowParameterClassificationsToInclude 'Critical'
ExcludedPatchCount FailedPatchCount InstallationActivityId               InstalledPatchCount LastModifiedDateTime Maint
                                                                                                                  enanc
                                                                                                                  eWind
                                                                                                                  owExc
                                                                                                                  eeded
------------------ ---------------- ----------------------               ------------------- -------------------- -----
0                  0                ********-****-****-****-********** 0                   7/28/2023 7:55:08 AM  False

安装计算机修补程序。

参数

-AsJob

以作业身份运行命令

参数属性

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

参数集

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

-Confirm

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

参数属性

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

参数集

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

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

参数属性

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

参数集

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

-InputObject

标识参数

参数属性

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

参数集

InstallViaIdentityExpanded
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentity
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InstallPatchesInput

API 直接接收的 InstallPatches 的输入

参数属性

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

参数集

Install
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentity
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-JsonFilePath

提供给安装作的 Json 文件的路径

参数属性

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

参数集

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

-JsonString

提供给安装作的 Json 字符串

参数属性

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

参数集

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

-LinuxParameterClassificationsToInclude

安装 Linux 修补程序时要选择的更新分类。

参数属性

类型:

String[]

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

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-LinuxParameterPackageNameMasksToExclude

要排除在修补程序作中的包。 格式:packageName_packageVersion

参数属性

类型:

String[]

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

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-LinuxParameterPackageNameMasksToInclude

要包含在修补作中的包。 格式:packageName_packageVersion

参数属性

类型:

String[]

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

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaximumDuration

指定作将运行的最大时间量。 它必须是符合 ISO 8601 的持续时间字符串,如 PT4H(4 小时)

参数属性

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

参数集

InstallExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

混合计算机的名称。

参数属性

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

参数集

InstallExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaJsonString
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaJsonFilePath
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
Install
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NoWait

异步运行命令

参数属性

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

参数集

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

-RebootSetting

定义在软件更新作期间重新启动 VM 是可以接受的。

参数属性

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

参数集

InstallExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

资源组的名称。

参数属性

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

参数集

InstallExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaJsonString
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaJsonFilePath
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
Install
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SubscriptionId

目标订阅的 ID。

参数属性

类型:String
默认值:(Get-AzContext).Subscription.Id
支持通配符:False
不显示:False

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaJsonString
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaJsonFilePath
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
Install
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

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

参数属性

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

参数集

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

-WindowParameterClassificationsToInclude

安装 Windows 修补程序时要选择的更新分类。

参数属性

类型:

String[]

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

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WindowParameterExcludeKbsRequiringReboot

筛选掉在设置为 true 时没有“NeverReboots”的 InstallationRebootBehavior 的 Kbs。

参数属性

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

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WindowParameterKbNumbersToExclude

在修补作中要排除的 Kbs

参数属性

类型:

String[]

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

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WindowParameterKbNumbersToInclude

要包含在修补作中的 Kbs

参数属性

类型:

String[]

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

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WindowParameterMaxPatchPublishDate

这用于安装在此给定最大发布日期或之前发布的修补程序。

参数属性

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

参数集

InstallExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
InstallViaIdentityExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

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

输入

IConnectedMachineIdentity

IMachineInstallPatchesParameters

输出

IMachineInstallPatchesResult