Invoke-AzVMInstallPatch
Installe des correctifs sur la machine virtuelle
Syntax
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
Installe des correctifs sur la machine virtuelle
Exemples
Exemple 1
Invoke-AzVmInstallPatch -ResourceGroupName 'MyRG' -VmName 'MyVM' -Windows -RebootSetting 'never' -MaximumDuration PT2H -ClassificationToIncludeForWindows Critical
Cet exemple installe des correctifs critiques sur la machine virtuelle.
Exemple 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
Cet exemple transmet un objet PSVirtualMachine au paramètre « -VM ». Il installe également les correctifs de sécurité tout en incluant et en excluant certaines Ko à l’aide de « -Ko NumberToExclude » et de « -Ko NumberToInclude ». Il exclut également les Ko qui nécessitent un redémarrage à l’aide de « -Exclude Ko sRequiringReboot ».
Exemple 3
$myLinuxVM = Get-AzVM -ResourceGroupName 'MyRG' -Name 'MyLinuxVM'
Invoke-AzVMInstallPatch -ResourceId $myLinuxVM.id -MaximumDuration "PT90M" -RebootSetting "Always" -Linux -ClassificationToIncludeForLinux "Security" -PackageNameMaskToInclude "package123" -PackageNameMaskToExclude "package567"
Cet exemple installe certains packages sur la machine virtuelle Linux fournie par l’ID de ressource.
Paramètres
-AsJob
Exécuter l’applet de commande en arrière-plan
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClassificationToIncludeForLinux
Classifications de mise à jour à sélectionner lors de l’installation des correctifs. Les valeurs possibles diffèrent pour Windows et Linux.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClassificationToIncludeForWindows
Classifications de mise à jour à sélectionner lors de l’installation des correctifs. Les valeurs possibles diffèrent pour Windows et Linux.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeKBsRequiringReboot
Filtre les Ko qui n’ont pas de comportement de redémarrage de « NeverReboots » quand cela est défini. Ce paramètre est disponible uniquement pour la machine virtuelle Windows.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KBNumberToExclude
Ko à exclure dans l’opération de correctif. Ce paramètre est disponible uniquement pour la machine virtuelle Windows.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KBNumberToInclude
Ko s à inclure dans l’opération de correctif. Ce paramètre est disponible uniquement pour la machine virtuelle Windows.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Linux
Pour une machine virtuelle Linux
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumDuration
Spécifie la durée maximale pendant laquelle l’opération s’exécutera. Il doit s’agir d’une chaîne de durée conforme ISO 8601 telle que PT2H (2 heures).
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageNameMaskToExclude
Packages à exclure dans l’opération de correctif. Format : packageName_packageVersion. Ce paramètre est disponible uniquement pour la machine virtuelle Linux.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageNameMaskToInclude
Packages à inclure dans l’opération de correctif. Format : packageName_packageVersion. Ce paramètre est disponible uniquement pour la machine virtuelle Linux.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RebootSetting
Définit quand il est acceptable de redémarrer une machine virtuelle pendant une opération de mise à jour logicielle.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Nom du groupe de ressources.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
ID de ressource pour votre machine virtuelle.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
Objet machine virtuelle PowerShell
Type: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Nom de la machine virtuelle
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Windows
Pour une machine virtuelle Windows
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Sorties
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour