Udostępnij przez

Invoke-AzVMInstallPatch

Moduł:
Az.Compute Module

Instaluje poprawki na maszynie wirtualnej

Składnia

WindowsDefaultParameterSet (Domyślne) 

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

Opis

Instaluje poprawki na maszynie wirtualnej

Przykłady

Przykład 1

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

W tym przykładzie na maszynie wirtualnej są instalowane poprawki krytyczne.

Przykład 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

Ten przykład przekazuje obiekt PSVirtualMachine do parametru "-VM". Instaluje również poprawki zabezpieczeń, włączając i wykluczając niektóre bazy wiedzy przy użyciu poleceń "-KBNumberToExclude" i "-KBNumberToInclude". Wyklucza również bazy danych, które wymagają ponownego uruchomienia przy użyciu polecenia "-ExcludeKBs RequireReboot".

Przykład 3

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

W tym przykładzie niektóre pakiety są instalowane na maszynie wirtualnej z systemem Linux dostarczonej przez identyfikator zasobu.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ClassificationToIncludeForLinux

Klasyfikacje aktualizacji do wybrania podczas instalowania poprawek. Możliwe wartości różnią się w przypadku systemów Windows i Linux.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

LinuxDefaultParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
LinuxResourceIDParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
LinuxInputObjectParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ClassificationToIncludeForWindows

Klasyfikacje aktualizacji do wybrania podczas instalowania poprawek. Możliwe wartości różnią się w przypadku systemów Windows i Linux.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

WindowsDefaultParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsResourceIDParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsInputObjectParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ExcludeKBsRequiringReboot

Filtruje bazy danych, które nie mają zachowania ponownego uruchamiania "NeverReboots", gdy jest ustawiona. Ten parametr jest dostępny tylko dla maszyny wirtualnej z systemem Windows.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

WindowsDefaultParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsResourceIDParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsInputObjectParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-KBNumberToExclude

KBs do wykluczenia w operacji poprawki. Ten parametr jest dostępny tylko dla maszyny wirtualnej z systemem Windows.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

WindowsDefaultParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsResourceIDParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsInputObjectParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-KBNumberToInclude

Bazy danych kBs do uwzględnienia w operacji stosowania poprawek. Ten parametr jest dostępny tylko dla maszyny wirtualnej z systemem Windows.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

WindowsDefaultParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsResourceIDParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsInputObjectParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Linux

Dla maszyny wirtualnej z systemem Linux

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

LinuxDefaultParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
LinuxResourceIDParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
LinuxInputObjectParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-MaximumDuration

Określa maksymalny czas uruchomienia operacji. Musi to być ciąg czasu trwania zgodny ze standardem ISO 8601, taki jak PT2H (2 godziny).

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-PackageNameMaskToExclude

Pakiety do wykluczenia w operacji poprawek. Format: packageName_packageVersion. Ten parametr jest dostępny tylko dla maszyny wirtualnej z systemem Linux.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

LinuxDefaultParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
LinuxResourceIDParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
LinuxInputObjectParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-PackageNameMaskToInclude

Pakiety do uwzględnienia w operacji stosowania poprawek. Format: packageName_packageVersion. Ten parametr jest dostępny tylko dla maszyny wirtualnej z systemem Linux.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

LinuxDefaultParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
LinuxResourceIDParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
LinuxInputObjectParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-RebootSetting

Określa, kiedy dopuszczalne jest ponowne uruchomienie maszyny wirtualnej podczas operacji aktualizacji oprogramowania.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ResourceGroupName

Nazwa grupy zasobów.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

WindowsDefaultParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
LinuxDefaultParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ResourceId

Identyfikator zasobu dla maszyny wirtualnej.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

WindowsResourceIDParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
LinuxResourceIDParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-VM

Obiekt maszyny wirtualnej programu PowerShell

Właściwości parametrów

Typ:PSVirtualMachine
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:VMProfile

Zbiory parametrów

WindowsInputObjectParameterSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
LinuxInputObjectParameterSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-VMName

Nazwa maszyny wirtualnej

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Name

Zbiory parametrów

WindowsDefaultParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
LinuxDefaultParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Windows

Dla maszyny wirtualnej z systemem Windows

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

WindowsDefaultParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsResourceIDParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
WindowsInputObjectParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

PSVirtualMachine

Wyjść

PSVirtualMachineInstallPatchesResult