Invoke-AzVMInstallPatch

Modulo:

Az.Compute

Installa le patch nella macchina virtuale

Sintassi

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

Descrizione

Installa le patch nella macchina virtuale

Esempio

Esempio 1

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

In questo esempio vengono installate patch critiche nella macchina virtuale.

Esempio 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

In questo esempio viene passato un oggetto PSVirtualMachine al parametro '-VM'. Vengono inoltre installate patch di sicurezza, incluse ed escluse determinate kb usando '-KBNumberToExclude' e '-KBNumberToInclude'. Esclude anche I KB che richiedono il riavvio usando '-ExcludeKBsRequiringReboot'.

Esempio 3

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

Questo esempio installa determinati pacchetti nella macchina virtuale Linux fornita dall'ID risorsa.

Parametri

-AsJob

Eseguire il cmdlet in background

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ClassificationToIncludeForLinux

Classificazioni degli aggiornamenti da selezionare durante l'installazione delle patch. I valori possibili sono diversi per Windows e Linux.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ClassificationToIncludeForWindows

Classificazioni degli aggiornamenti da selezionare durante l'installazione delle patch. I valori possibili sono diversi per Windows e Linux.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ExcludeKBsRequiringReboot

Filtra i KB che non hanno un comportamento di riavvio di 'NeverReboots' quando è impostato. Questo parametro è disponibile solo per la macchina virtuale Windows.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-KBNumberToExclude

Kb da escludere nell'operazione di patch. Questo parametro è disponibile solo per la macchina virtuale Windows.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-KBNumberToInclude

Kb da includere nell'operazione di patch. Questo parametro è disponibile solo per la macchina virtuale Windows.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Linux

Per la macchina virtuale Linux

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MaximumDuration

Specifica la quantità massima di tempo di esecuzione dell'operazione. Deve essere una stringa di durata conforme a ISO 8601, ad esempio PT2H (2 ore).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PackageNameMaskToExclude

Pacchetti da escludere nell'operazione patch. Formato: packageName_packageVersion. Questo parametro è disponibile solo per la macchina virtuale Linux.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PackageNameMaskToInclude

Pacchetti da includere nell'operazione patch. Formato: packageName_packageVersion. Questo parametro è disponibile solo per la macchina virtuale Linux.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RebootSetting

Definisce quando è accettabile riavviare una macchina virtuale durante un'operazione di aggiornamento software.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ResourceGroupName

Il nome del gruppo di risorse.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ResourceId

ID risorsa per la macchina virtuale.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-VM

Oggetto Macchina virtuale PowerShell

Tipo:	PSVirtualMachine
Alias:	VMProfile
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-VMName

Nome macchina virtuale

Tipo:	String
Alias:	Name
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Windows

Per la macchina virtuale Windows

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

String

PSVirtualMachine

Output

PSVirtualMachineInstallPatchesResult