Invoke-AzVMInstallPatch

Menginstal patch pada VM

Sintaks

WindowsDefaultParameterSet (Default)

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

LinuxDefaultParameterSet

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

WindowsResourceIDParameterSet

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

LinuxResourceIDParameterSet

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

WindowsInputObjectParameterSet

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

LinuxInputObjectParameterSet

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

Deskripsi

Menginstal patch pada VM

Contoh

Contoh 1

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

Contoh ini menginstal patch penting pada VM.

Contoh 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

Contoh ini meneruskan objek PSVirtualMachine ke parameter '-VM'. Ini juga menginstal patch keamanan sambil menyertakan dan mengecualikan KB tertentu dengan menggunakan '-KBNumberToExclude' dan '-KBNumberToInclude'. Ini juga mengecualikan KB yang memerlukan boot ulang dengan menggunakan '-ExcludeKBsRequiringReboot'.

Contoh 3

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

Contoh ini menginstal paket tertentu ke VM Linux yang disediakan oleh ID Sumber Daya.

Parameter

-AsJob

Jalankan cmdlet di latar belakang

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ClassificationToIncludeForLinux

Klasifikasi pembaruan untuk dipilih saat menginstal patch. Nilai yang mungkin berbeda untuk Windows dan Linux.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

LinuxDefaultParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
LinuxResourceIDParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
LinuxInputObjectParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ClassificationToIncludeForWindows

Klasifikasi pembaruan untuk dipilih saat menginstal patch. Nilai yang mungkin berbeda untuk Windows dan Linux.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

WindowsDefaultParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsResourceIDParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsInputObjectParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Properti parameter

Jenis:IAzureContextContainer
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ExcludeKBsRequiringReboot

Memfilter KB yang tidak memiliki perilaku boot ulang 'NeverReboots' saat ini diatur. Parameter ini hanya tersedia untuk VM Windows.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

WindowsDefaultParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsResourceIDParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsInputObjectParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-KBNumberToExclude

KB untuk dikecualikan dalam operasi patch. Parameter ini hanya tersedia untuk VM Windows.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

WindowsDefaultParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsResourceIDParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsInputObjectParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-KBNumberToInclude

KB untuk disertakan dalam operasi patch. Parameter ini hanya tersedia untuk VM Windows.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

WindowsDefaultParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsResourceIDParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsInputObjectParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Linux

Untuk VM Linux

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

LinuxDefaultParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
LinuxResourceIDParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
LinuxInputObjectParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-MaximumDuration

Menentukan jumlah waktu maksimum operasi akan berjalan. Ini harus berupa string durasi yang mematuhi ISO 8601 seperti PT2H (2 jam).

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-PackageNameMaskToExclude

Paket yang akan dikecualikan dalam operasi patch. Format: packageName_packageVersion. Parameter ini hanya tersedia untuk VM Linux.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

LinuxDefaultParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
LinuxResourceIDParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
LinuxInputObjectParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-PackageNameMaskToInclude

Paket untuk disertakan dalam operasi patch. Format: packageName_packageVersion. Parameter ini hanya tersedia untuk VM Linux.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

LinuxDefaultParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
LinuxResourceIDParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
LinuxInputObjectParameterSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-RebootSetting

Menentukan kapan dapat diterima untuk me-reboot VM selama operasi pembaruan perangkat lunak.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ResourceGroupName

Nama grup sumber daya.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

WindowsDefaultParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
LinuxDefaultParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ResourceId

ID sumber daya untuk komputer virtual Anda.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

WindowsResourceIDParameterSet
Position:Named
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
LinuxResourceIDParameterSet
Position:Named
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-VM

Objek Komputer Virtual PowerShell

Properti parameter

Jenis:PSVirtualMachine
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:VMProfile

Kumpulan parameter

WindowsInputObjectParameterSet
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
LinuxInputObjectParameterSet
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-VMName

Nama Komputer Virtual

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:Name

Kumpulan parameter

WindowsDefaultParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False
LinuxDefaultParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Windows

Untuk VM Windows

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

WindowsDefaultParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsResourceIDParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
WindowsInputObjectParameterSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

PSVirtualMachine

Output

PSVirtualMachineInstallPatchesResult