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 |