Edit-SCOMMaintenanceSchedule

Module:

OperationsManager

Modifie une planification de maintenance existante.

Syntaxe

Edit-SCOMMaintenanceSchedule
    [-ScheduleId] <Guid>
    [[-Name] <String>]
    [[-Recursive] <Boolean>]
    [[-Enabled] <Boolean>]
    [[-MonitoringObjects] <Guid[]>]
    [[-ActiveStartTime] <DateTime>]
    [[-ActiveEndDate] <DateTime>]
    [[-Duration] <Int32>]
    [[-ReasonCode] <MaintenanceModeReason>]
    [[-Comments] <String>]
    [[-FreqType] <Int32>]
    [[-FreqInterval] <Int32>]
    [[-FreqRecurrenceFactor] <Int32>]
    [[-FreqRelativeInterval] <Int32>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

La cmdlet Edit-SCOMMaintenanceSchedule modifie une planification de maintenance existante. Toutefois, vous ne pouvez pas modifier une planification actuellement active.

Lorsqu’une ressource est en mode maintenance, Operations Manager supprime les alertes, les notifications, les règles, les moniteurs, les réponses automatiques, les modifications d’état et les nouvelles alertes. Une planification de maintenance peut être utilisée pour planifier un ensemble de ressources pour passer en mode maintenance.

Vous pouvez utiliser cette applet de commande pour modifier les planifications pour qu’elles s’exécutent une fois, tous les jours, toutes les semaines ou tous les mois sur une journée ou un jour de la semaine. Vous devez passer l'ScheduleId d’une planification existante que vous souhaitez modifier. Tous les autres paramètres sont facultatifs ; les paramètres spécifiés sont remplacés.

Par défaut, cette applet de commande utilise la connexion persistante active à un groupe d’administration. Utilisez le paramètre SCSession pour spécifier une connexion persistante différente. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential. Pour plus d’informations, tapez Get-Help about_OpsMgr_Connections.

Exemples

1 : Modifier un mode de maintenance System Center Operations Manager planifié à l’aide de l’ID

PS C:\>Edit-SCOMMaintenanceSchedule -ScheduleId "32AAB279-3670-ED11-9626-00155D012405" -Enabled 1

Modifie la planification du mode maintenance avec l’ID 32AAB279-3670-ED11-9626-00155D012405.

2 : Modifier un mode de maintenance System Center Operations Manager planifié à l’aide de son nom

PS C:\>Edit-SCOMMaintenanceSchedule -Name "Test" -Enabled 1

Modifie la planification du mode maintenance avec le nom.

Paramètres

-ActiveEndDate

Spécifie la date de fin et l’heure de fin de l’arrêt de la planification. Si vous ne spécifiez pas ce paramètre, la planification continue à s’exécuter jusqu’à ce qu’elle soit supprimée ou désactivée.

Par exemple, si vous souhaitez créer une planification qui devrait se terminer le 1er mai 2016 à 19h00, vous devez spécifier « 01-05-2016 09:00:00 » comme ActiveEndDate. Vous pouvez passer une chaîne spécifiant l’heure souhaitée dans votre heure locale. Toutefois, si vous souhaitez spécifier une heure UTC, vous devez spécifier un objet DateTime avec le paramètre DateTimeKind défini sur UTC.

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

-ActiveStartTime

Spécifie la date de début et l’heure à laquelle la planification doit être active. Par exemple, si vous souhaitez une planification qui doit commencer le 1er mai 2016 et qui doit s’exécuter à 9h00, vous devez spécifier « 01-05-2016 09:00:00 » comme ActiveStartTime. Vous pouvez passer une chaîne spécifiant l’heure souhaitée dans votre heure locale. Toutefois, si vous souhaitez spécifier une heure UTC, vous devez spécifier un objet DateTime avec DateTimeKind.

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

-Comments

Spécifie tous les commentaires lisibles par l’homme pour une planification de maintenance.

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

-ComputerName

Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.). Le service System Center Data Access doit être actif sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion de groupe d’administration actuelle.

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-Credential

Spécifie un objet PSCredential pour la connexion de groupe d’administration. Pour obtenir un objet PSCredential, utilisez l’applet de commande Get-Credential. Pour plus d’informations, tapez . Si vous spécifiez un ordinateur dans le paramètre ComputerName , utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.

Type:	PSCredential
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

Spécifie la durée de la planification de maintenance. La durée d’une planification de maintenance est l’heure à laquelle la planification de maintenance durera chaque fois.

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

-Enabled

Indique si la planification sera activée ou désactivée lors de la modification. Si vous définissez cette valeur sur false, la planification est désactivée. Vous pouvez également utiliser les Enable-SCOMMaintenanceSchedule et les Disable-SCOMMaintenanceSchedule pour ce faire.

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

-FreqInterval

Spécifie le jour où le travail est exécuté. Cela est obligatoire si la planification est autre que la planification OnceRecurrence. La valeur dépend de la valeur de FreqType comme indiqué dans la liste suivante :

• 1 (une fois). L’intervalle de fréquence n’est pas utilisé.
• 4 (tous les jours). Tous les jours d’intervalle de fréquence.
• 8 (hebdomadaire). Le paramètre FreqInterval est un ou plusieurs des éléments suivants (combinés avec un opérateur logique OR) :

---- 1 = Dimanche ---- 2 = Lundi ---- 4 = Mardi ---- 8 = Mercredi ---- 16 = Jeudi ---- 32 = Vendredi ---- 64 = Samedi

• 16 (mensuel). Sur le jour d’intervalle de fréquence du mois.
• 32 (relatif mensuel). Le paramètre FreqInterval est l’une des valeurs suivantes :

---- 1 = Dimanche ---- 2 = Lundi ---- 3 = Mardi ---- 4 = Mercredi ---- 5 = Jeudi ---- 6 = Vendredi ---- 7 = Samedi ---- 8 = Jour ---- 9 = Jour ---- 10 = Jour du week-end

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

-FreqRecurrenceFactor

Nombre de semaines ou de mois entre l’exécution planifiée du travail. FreqRecurrenceFactor est utilisé uniquement si le FreqType paramter est défini sur 8, 16 ou 32. Le paramètre FreqRecurrenceFactor est un entier, avec une valeur par défaut de 0.

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

-FreqRelativeInterval

Spécifie la planification lorsque le paramètre FreqType est défini sur 32 (relatif mensuel). Ce paramètre peut être l’une des valeurs suivantes :

• 1 (Premier)
• 2 (Seconde)
• 4 (Troisième)
• 8 (Quatrième)
• 16 (Dernier)

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

-FreqType

Spécifie quand le travail doit être exécuté. Ce paramètre peut être l’une des valeurs suivantes :

• 1 (une fois)
• 4 (tous les jours)
• 8 (hebdomadaire)
• 16 (mensuel)
• 32 (Mensuel, par rapport au paramètre FreqInterval).

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

-MonitoringObjects

Spécifie un tableau de GUID représentant des objets de surveillance que cette applet de commande place en mode maintenance. Spécifie un tableau de GUID d’objets de surveillance placés en mode maintenance. Pour spécifier un objet de surveillance que la planification place en mode maintenance, vous devez transmettre l’attribut ID de l’objet de surveillance. Si vous souhaitez conserver certains des membres existants, ceux-ci doivent également être spécifiés.

Vous pouvez spécifier un ou plusieurs objets de surveillance pour une planification. Toutefois, vous ne pouvez pas modifier une planification qui n’a pas d’objet de surveillance.

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

-Name

Spécifie le nom de la planification.

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

-ReasonCode

Spécifie le code de raison d’une planification de maintenance qui spécifie la raison de la fenêtre de maintenance.

Type:	MaintenanceModeReason
Valeurs acceptées:	PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:	8
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Recursive

Indique que la planification s’applique également à la ressource de niveau supérieur ou à toutes les ressources contenues. Si vous définissez ce paramètre sur false, seule la ressource spécifiée passe en mode maintenance lorsque la planification est exécutée. Si cette valeur est définie sur true, la ressource spécifiée et toutes les ressources qui ont une relation d’isolement avec cette ressource passent également en mode maintenance.

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

-ScheduleId

Spécifie le GUID de la planification que cette applet de commande modifie.

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

-SCSession

Spécifie un tableau d’objets Connection.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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

Liens associés

• Disable-SCOMMaintenanceSchedule
• Enable-SCOMMaintenanceSchedule
• Get-SCOMMaintenanceSchedule
• New-SCOMMaintenanceSchedule
• Remove-SCOMMaintenanceSchedule
• Stop-SCOMMaintenanceSchedule
• Update-SCOMMaintenanceSchedule