New-AzAutomationSoftwareUpdateConfiguration

Référence

Module:: Az.Automation

Crée une configuration de mise à jour logicielle Azure Automation planifiée.

Syntaxe

New-AzAutomationSoftwareUpdateConfiguration
   -Schedule <Schedule>
   [-Windows]
   [-RebootOnly]
   [-AzureVMResourceId <String[]>]
   [-PreTaskRunbookName <String>]
   [-PostTaskRunbookName <String>]
   [-PreTaskRunbookParameter <Hashtable>]
   [-PostTaskRunbookParameter <Hashtable>]
   [-NonAzureComputer <String[]>]
   [-AzureQuery <AzureQueryProperties[]>]
   [-NonAzureQuery <NonAzureQueryProperties[]>]
   [-Duration <TimeSpan>]
   [-RebootSetting <RebootSetting>]
   [-IncludedUpdateClassification <WindowsUpdateClasses[]>]
   [-ExcludedKbNumber <String[]>]
   [-IncludedKbNumber <String[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAutomationSoftwareUpdateConfiguration
   -Schedule <Schedule>
   [-Linux]
   [-RebootOnly]
   [-AzureVMResourceId <String[]>]
   [-PreTaskRunbookName <String>]
   [-PostTaskRunbookName <String>]
   [-PreTaskRunbookParameter <Hashtable>]
   [-PostTaskRunbookParameter <Hashtable>]
   [-NonAzureComputer <String[]>]
   [-AzureQuery <AzureQueryProperties[]>]
   [-NonAzureQuery <NonAzureQueryProperties[]>]
   [-Duration <TimeSpan>]
   [-RebootSetting <RebootSetting>]
   [-IncludedPackageClassification <LinuxPackageClasses[]>]
   [-ExcludedPackageNameMask <String[]>]
   [-IncludedPackageNameMask <String[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Crée une configuration de mise à jour logicielle qui s’exécute selon une planification pour mettre à jour une liste d’ordinateurs. Les ordinateurs incluent des machines virtuelles Azure ou des ordinateurs non-az.

Exemples

Exemple 1

Crée une configuration de mise à jour logicielle pour installer les mises à jour critiques sur deux machines virtuelles Windows Azure une fois tous les samedis 9h00. La durée de mise à jour est définie sur 2 heures dans cet exemple.

$startTime = [DateTimeOffset]"2018-09-13T21:00"
$targetMachines = @(
    "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/vm-w-01",
    "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/vm-w-02"
)
$duration = New-TimeSpan -Hours 2
$schedule = New-AzAutomationSchedule -ResourceGroupName "mygroup" `
                                                  -AutomationAccountName "myaccount" `
                                                  -Name MyWeeklySchedule `
                                                  -StartTime $startTime `
                                                  -DaysOfWeek Saturday `
                                                  -WeekInterval 1 `
                                                  -ForUpdateConfiguration

New-AzAutomationSoftwareUpdateConfiguration -ResourceGroupName "mygroup" `
                                                 -AutomationAccountName "myaccount" `
                                                 -Schedule $schedule `
                                                 -Windows `
                                                 -AzureVMResourceId $targetMachines `
                                                 -IncludedUpdateClassification Critical `
                                                 -Duration $duration

UpdateConfiguration   : Microsoft.Azure.Commands.Automation.Model.UpdateManagement.UpdateConfiguration
ScheduleConfiguration : Microsoft.Azure.Commands.Automation.Model.Schedule
ProvisioningState     : Provisioning
ErrorInfo             :
ResourceGroupName     : mygroup
AutomationAccountName : myaccount
Name                  : MyWeeklySchedule
CreationTime          : 9/14/2018 3:53:27 AM +00:00
LastModifiedTime      : 9/14/2018 3:53:27 AM +00:00
Description           :

Paramètres

-AutomationAccountName

Nom du compte Automation.

Type:	String
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-AzureQuery

Requête Azure de groupe dynamique.

Type:	AzureQueryProperties[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-AzureVMResourceId

ID de ressource pour les machines virtuelles Azure.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Duration

Durée maximale de la mise à jour.

Type:	TimeSpan
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ExcludedKbNumber

Nombre de ko de mises à jour exclues.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ExcludedPackageNameMask

Masques de package Linux exclus.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-IncludedKbNumber

Nombre de ko de mises à jour incluses.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-IncludedPackageClassification

Classifications de package Linux incluses.

Type:	LinuxPackageClasses[]
Valeurs acceptées:	Unclassified, Critical, Security, Other
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-IncludedPackageNameMask

Masques de package Linux inclus.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-IncludedUpdateClassification

Classifications Windows Update incluses.

Type:	WindowsUpdateClasses[]
Valeurs acceptées:	Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Linux

Indique que la configuration de la mise à jour logicielle ciblant les machines du système d’exploitation Linux.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-NonAzureComputer

Noms d’ordinateurs non-Az.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-NonAzureQuery

Requête de groupe dynamique non Azure.

Type:	NonAzureQueryProperties[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-PostTaskRunbookName

Publier la tâche.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-PostTaskRunbookParameter

Publier le paramètre de tâche.

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-PreTaskRunbookName

Pré-tâche.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-PreTaskRunbookParameter

Paramètre de pré-tâche.

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-RebootOnly

Indique que la configuration de la mise à jour logicielle redémarre uniquement les machines.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-RebootSetting

Paramètre de redémarrage.

Type:	RebootSetting
Valeurs acceptées:	IfRequired, Never, Always, RebootOnly
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ResourceGroupName

Nom du groupe de ressources.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Schedule

Planifier l’objet utilisé pour la configuration des mises à jour logicielles.

Type:	Schedule
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	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
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Windows

Indique que la configuration de la mise à jour logicielle ciblant les machines du système d’exploitation Windows.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False