Partager via


Edit-SCOMMaintenanceSchedule

Modifie une planification de maintenance existante.

Syntax

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

L’applet de commande 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 analyses, les réponses automatiques, les changements d’état et les nouvelles alertes. Une planification de maintenance peut être utilisée pour planifier un ensemble de ressources en mode maintenance.

Vous pouvez utiliser cette applet de commande pour modifier les planifications pour qu’elles s’exécutent une fois, quotidiennement, hebdomadairement ou mensuellement sur un jour particulier ou un jour de la semaine. Vous devez passer le 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 permanente 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, voir 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 à laquelle la planification s’arrête. Si vous ne spécifiez pas ce paramètre, la planification continue de s’exécuter jusqu’à ce qu’elle soit supprimée ou désactivée.

Par instance, si vous souhaitez créer une planification qui doit se terminer le 1er mai 2016 à 09h00, 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 dateTimeKind défini sur UTC.

Type:DateTime
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 à partir du 1er mai 2016 et doit s’exécuter à 09h00, 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 le DateTimeKind.

Type:DateTime
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Comments

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

Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Spécifie un objet PSCredential pour la connexion du groupe d’administration. Pour obtenir un objet PSCredential, utilisez l'applet de commande Get-Credential. Pour plus d’informations, tapez Get-Help Get-Credential. 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Duration

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

Type:Int32
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqInterval

Spécifie le jour d’exécution du travail. 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 (par jour). Tous les jours d’intervalle de fréquence.
  • 8 (hebdomadaire). Le paramètre FreqInterval est l’un ou plusieurs des éléments suivants (combinés à un opérateur logique OR) :

---- 1 = dimanche ---- 2 = lundi ---- 4 = mardi ---- 8 = mercredi ---- 16 = jeudi ---- 32 = vendredi ---- 64 = samedi

  • 16 (mensuel). Jour de l’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 de semaine ---- 10 = Jour de fin de semaine

Type:Int32
Position:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRecurrenceFactor

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

Type:Int32
Position:12
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 (Deuxième)
  • 4 (Troisième)
  • 8 (Quatrième)
  • 16 (Dernier)
Type:Int32
Position:13
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqType

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

  • 1 (une fois)
  • 4 (quotidiennement)
  • 8 (hebdomadairement)
  • 16 (mensuellement)
  • 32 (mensuel, relatif au paramètre FreqInterval).
Type:Int32
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 passer 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom de la planification.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Accepted values:PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 lors de l’exécution de la planification. Si cette valeur est true, la ressource spécifiée et toutes les ressources qui ont une relation de confinement avec cette ressource passent également en mode maintenance.

Type:Boolean
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleId

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

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Spécifie un tableau d’objets Connection .

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False