Partager via

New-SCOMMaintenanceSchedule

  • Référence
Module:
OperationsManager

Crée une planification de maintenance.

Syntaxe

New-SCOMMaintenanceSchedule
   [-Name] <String>
   [-Recursive]
   [-Enabled]
   [-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 New-SCOMMaintenanceSchedule crée une planification de maintenance.

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 créer des planifications qui s’exécutent une fois, quotidiennes, hebdomadaires ou mensuelles sur un jour particulier ou un jour de la semaine. Cette applet de commande retourne le GUID de la planification créée.

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

Exemple 1 : Ajouter un objet Ordinateur Windows dans une nouvelle planification de maintenance

PS C:\>$windowsComputer = Get-SCOMClass -DisplayName "Windows Computer" | Get-SCOMClassInstance | Where-Object { $_.DisplayName -eq 'Agent01.contoso.local' }
PS C:\>New-SCOMMaintenanceSchedule -Name 'Test Maintenance Schedule' -MonitoringObjects $windowsComputer.Id -ActiveStartTime $((Get-Date).AddMinutes(2)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

Exemple montrant comment ajouter un objet ordinateur Windows pour un serveur spécifique : Agent01.contoso.com dans la nouvelle planification de maintenance, pendant une durée de 240 minutes, en exécutant seulement 1 fois.

Exemple 2 : Créer une planification de maintenance quotidienne

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is UTC (Coordinated Universal Time)
PS C:\>$startDate = [DateTime]::SpecifyKind([DateTime]"2024-03-30T01:00:00", [System.DateTimeKind]::Utc)
PS C:\>$durationInMinutes = 90
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Daily Maintenance at 1AM" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 4 -FreqInterval 1 -Enabled

Exemple montrant comment configurer une planification de maintenance quotidienne pour un serveur spécifique et des objets de surveillance associés : Agent01.contoso.local, à partir de 1h00 et pendant 90 minutes.

Exemple 3 : Créer une planification de maintenance hebdomadaire

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-03-29T02:00:00"
PS C:\>$durationInMinutes = 120
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Weekly Wednesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 8 -FreqInterval 8 -FreqRecurrenceFactor 1 -Enabled

Exemple montrant comment configurer une planification de maintenance hebdomadaire tous les mercredis pour un serveur spécifique et des objets de surveillance associés : Agent01.contoso.local, à partir de 2h00 et pendant 120 minutes.

Exemple 4 : Créer une planification de maintenance mensuelle

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-04-01T03:00:00"
PS C:\>$durationInMinutes = 180
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Monthly Second Tuesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 32 -FreqInterval 2 -FreqRelativeInterval 2 -FreqRecurrenceFactor 1 -Enabled

Exemple montrant comment établir une planification de maintenance mensuelle le deuxième mardi de chaque mois pour un serveur spécifique et les objets de surveillance associés : Agent01.contoso.local, à partir de 3h00 et pendant 180 minutes.

Paramètres

-ActiveEndDate

Spécifie la date de fin et l’heure de fin de l’exécution de la planification. Si ce paramètre n’est pas spécifié, la planification continue à s’exécuter pour toujours (ou 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:5
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 créer 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 le paramètre DateTimeKind défini sur UTC.

Type:DateTime
Position:4
Valeur par défaut:None
Obligatoire:True
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:8
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.

Type:Int32
Alias:DurationInMinutes
Position:6
Valeur par défaut:None
Obligatoire:True
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 création. Si vous définissez cette valeur sur false, la planification sera créée, mais elle sera désactivée.

Type:SwitchParameter
Position:2
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 quand le travail doit être exécuté. Ce paramètre peut être l’une des valeurs suivantes :

  • 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.
    • 1 - Dimanche
    • 2 - Lundi
    • 3 - Mardi
    • 4 - Mercredi
    • 5 - Jeudi
    • 6 - Vendredi
    • 7 - Samedi
  • 32 (relatif mensuel). Le paramètre FreqInterval est l’une des valeurs suivantes :
    • 8 - Jour
    • 9 - Semaine
    • 10 - Week-end
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

-FreqRecurrenceFactor

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

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

-FreqRelativeInterval

Jour où le travail est exécuté. Cela est obligatoire si la planification n’est autre que OnceRecurrence planification. La valeur dépend de la valeur de FreqType.

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:12
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é. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • 1 (une fois)
  • 4 (tous les jours)
  • 8 (hebdomadaire)
  • 16 (mensuel)
  • 32 (Mensuel, par rapport au paramètre FreqInterval)
Type:Int32
Position:9
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonitoringObjects

Spécifie un tableau de GUID d’objets de surveillance qui seront placés en mode maintenance. Pour spécifier un objet de surveillance que la planification créée met en mode maintenance, vous devez transmettre l’attribut ID de l’objet de surveillance.

Vous pouvez spécifier un ou plusieurs objets de surveillance pour une planification. Toutefois, vous ne pouvez pas créer une planification sans objet de surveillance.

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

-Name

Spécifie le nom de la planification créée par cette applet de commande.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
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.

Les valeurs acceptables pour ce paramètre sont les suivantes :

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

-Recursive

Indique si la planification s’applique à la ressource de niveau supérieur ou à toutes les ressources contenues. Si le paramètre récursif est défini 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:SwitchParameter
Position:1
Valeur par défaut:None
Obligatoire:False
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