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

Invoke-AzVMInstallPatch

参考

模块:: Az.Compute

在 VM 上安装修补程序

语法

Invoke-AzVMInstallPatch
      -ResourceGroupName <String>
      -VMName <String>
      [-Windows]
      -RebootSetting <String>
      -MaximumDuration <String>
      [-KBNumberToInclude <String[]>]
      [-KBNumberToExclude <String[]>]
      [-ExcludeKBsRequiringReboot]
      [-ClassificationToIncludeForWindows <String[]>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzVMInstallPatch
      -ResourceGroupName <String>
      -VMName <String>
      [-Linux]
      -RebootSetting <String>
      -MaximumDuration <String>
      [-PackageNameMaskToInclude <String[]>]
      [-PackageNameMaskToExclude <String[]>]
      [-ClassificationToIncludeForLinux <String[]>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzVMInstallPatch
      -ResourceId <String>
      [-Windows]
      -RebootSetting <String>
      -MaximumDuration <String>
      [-KBNumberToInclude <String[]>]
      [-KBNumberToExclude <String[]>]
      [-ExcludeKBsRequiringReboot]
      [-ClassificationToIncludeForWindows <String[]>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzVMInstallPatch
      -ResourceId <String>
      [-Linux]
      -RebootSetting <String>
      -MaximumDuration <String>
      [-PackageNameMaskToInclude <String[]>]
      [-PackageNameMaskToExclude <String[]>]
      [-ClassificationToIncludeForLinux <String[]>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzVMInstallPatch
      [-VM] <PSVirtualMachine>
      [-Windows]
      -RebootSetting <String>
      -MaximumDuration <String>
      [-KBNumberToInclude <String[]>]
      [-KBNumberToExclude <String[]>]
      [-ExcludeKBsRequiringReboot]
      [-ClassificationToIncludeForWindows <String[]>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzVMInstallPatch
      [-VM] <PSVirtualMachine>
      [-Linux]
      -RebootSetting <String>
      -MaximumDuration <String>
      [-PackageNameMaskToInclude <String[]>]
      [-PackageNameMaskToExclude <String[]>]
      [-ClassificationToIncludeForLinux <String[]>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

在 VM 上安装修补程序

示例

示例 1

Invoke-AzVmInstallPatch -ResourceGroupName 'MyRG' -VmName 'MyVM' -Windows -RebootSetting 'never' -MaximumDuration PT2H -ClassificationToIncludeForWindows Critical

此示例在 VM 上安装关键修补程序。

示例 2

$myVM = Get-AzVM -ResourceGroupName 'MyRG' -Name 'MyVM'
Invoke-AzVmInstallPatch -VM $myVM -MaximumDuration "PT90M" -RebootSetting "Always" -Windows -ClassificationToIncludeForWindows "Security" -KBNumberToInclude "KB1234567", "KB123567" -KBNumberToExclude "KB1234702", "KB1234802" -ExcludeKBsRequiringReboot

此示例将 PSVirtualMachine 对象传递给“-VM”参数。它还使用“-知识库(KB)NumberToExclude”和“-知识库(KB)NumberToInclude”来包括和排除某些知识库(KB)时安装安全修补程序。它还排除使用“-Exclude知识库(KB)sRequiringReboot”需要重新启动的知识库(KB)。

示例 3

$myLinuxVM = Get-AzVM -ResourceGroupName 'MyRG' -Name 'MyLinuxVM'
Invoke-AzVMInstallPatch -ResourceId $myLinuxVM.id -MaximumDuration "PT90M" -RebootSetting "Always" -Linux -ClassificationToIncludeForLinux "Security" -PackageNameMaskToInclude "package123" -PackageNameMaskToExclude "package567"

此示例将某些包安装到资源 ID 提供的 Linux VM。

参数

-AsJob

在后台运行 cmdlet

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClassificationToIncludeForLinux

安装修补程序时要选择的更新分类。 Windows 和 Linux 的可能值有所不同。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClassificationToIncludeForWindows

安装修补程序时要选择的更新分类。 Windows 和 Linux 的可能值有所不同。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExcludeKBsRequiringReboot

筛选掉知识库(KB)设置时没有“NeverReboots”的重新启动行为。此参数仅适用于 Windows VM。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KBNumberToExclude

要排除在修补操作中的知识库(KB)。此参数仅适用于 Windows VM。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KBNumberToInclude

要包括在修补操作中的知识库(KB)。此参数仅适用于 Windows VM。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Linux

对于 Linux VM

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumDuration

指定操作将运行的最大时间量。它必须是符合 ISO 8601 的持续时间字符串，例如 PT2H（2 小时）。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageNameMaskToExclude

要排除在修补操作中的包。格式：packageName_packageVersion。此参数仅适用于 Linux VM。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageNameMaskToInclude

要包含在修补操作中的包。格式：packageName_packageVersion。此参数仅适用于 Linux VM。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RebootSetting

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

资源组名称。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceId

虚拟机的资源 ID。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VM

PowerShell 虚拟机对象

Type:	PSVirtualMachine
Aliases:	VMProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

虚拟机名称

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Windows

对于 Windows VM

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

输入

String

PSVirtualMachine

输出

PSVirtualMachineInstallPatchesResult