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>]

Description

在 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』參數。它也會安裝安全性修補程式，同時使用『-KBNumberToExclude』和『-KBNumberToInclude』來包含和排除特定 KB。它也會排除需要使用『-ExcludeKBsRequiringReboot』重新啟動的 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"

此範例會將特定套件安裝到資源標識碼所提供的Linux VM。

參數

-AsJob

在背景執行 Cmdlet

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClassificationToIncludeForLinux

安裝修補程式時要選取的更新分類。 Windows 和 Linux 的可能值不同。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClassificationToIncludeForWindows

安裝修補程式時要選取的更新分類。 Windows 和 Linux 的可能值不同。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExcludeKBsRequiringReboot

篩選掉設定此選項時，沒有 'NeverReboots' 重新啟動行為的 KB。此參數僅適用於 Windows VM。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KBNumberToExclude

修補作業中要排除的 KB。此參數僅適用於 Windows VM。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KBNumberToInclude

要包含在修補作業中的 KB。此參數僅適用於 Windows VM。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Linux

針對 Linux VM

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-MaximumDuration

指定作業執行的時間上限。它必須是符合 ISO 8601 規範的持續時間字串，例如 PT2H（2 小時）。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PackageNameMaskToExclude

修補作業中要排除的套件。格式：packageName_packageVersion。此參數僅適用於Linux VM。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PackageNameMaskToInclude

要包含在修補作業中的套件。格式：packageName_packageVersion。此參數僅適用於Linux VM。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RebootSetting

定義在軟體更新作業期間可接受重新啟動 VM 的時機。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源組名。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ResourceId

虛擬機的資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-VM

PowerShell 虛擬機物件

類型:	PSVirtualMachine
別名:	VMProfile
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-VMName

虛擬機名稱

類型:	String
別名:	Name
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Windows

針對 Windows VM

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

輸入

String

PSVirtualMachine

輸出

PSVirtualMachineInstallPatchesResult

共用方式為