Partager via

Set-SCOMMaintenanceMode

  • Référence
Module:
OperationsManager

Met à jour les entrées en mode maintenance actif.

Syntaxe

Set-SCOMMaintenanceMode
   [-MaintenanceModeEntry] <MaintenanceWindow[]>
   [-PassThru]
   [-EndTime] <DateTime>
   [[-Comment] <String>]
   [[-Reason] <MaintenanceModeReason>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-SCOMMaintenanceMode met à jour les entrées en mode maintenance actif. Vous pouvez utiliser cette applet de commande pour mettre à jour uniquement les entrées actives.

Lorsqu’une ressource est en mode maintenance, System Center - Operations Manager supprime les alertes, les notifications, les règles, les analyses, les réponses automatiques, les modifications d’état et les nouvelles alertes.

Vous pouvez modifier le commentaire ou la raison du mode maintenance. Utilisez l’applet de commande Get-SCOMMaintenanceMode pour obtenir une entrée en mode maintenance à mettre à jour. Spécifiez une fin pour la fenêtre de maintenance.

Exemples

Exemple 1 : Mettre à jour les entrées en mode maintenance active pour les ressources d’un domaine

PS C:\>$NewEndTime = (Get-Date).addDays(1)
PS C:\> Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode | Set-SCOMMaintenanceMode -EndTime $NewEndTime -Comment "Updating end time."

Cet exemple met à jour toutes les entrées en mode maintenance active pour un domaine spécifié. La première commande crée un objet DateTime pour un jour à l’avenir, puis le stocke dans la variable $NewEndTime.

La deuxième commande obtient toutes les instances de classe dans le domaine Contoso.com et utilise l’opérateur de pipeline (|) pour transmettre les objets d’instance de classe à l’applet de commande Get-SCOMMaintenanceMode, qui obtient les objets d’entrée en mode maintenance. La commande utilise l’opérateur de pipeline pour passer ces objets à l’applet de commande Set-SCOMMaintenanceMode. Cette applet de commande met à jour l’heure de fin de chaque objet vers l’objet DateTime stocké dans la variable $NewEndTime. La commande inclut également un commentaire pour chaque entrée en mode maintenance mise à jour.

Exemple 2 : Mettre à jour l’entrée du mode maintenance pour une ressource spécifiée

PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $MMEntry = Get-SCOMMaintenanceMode -Instance $Instance
PS C:\> $NewEndTime = (Get-Date).addMinutes(30)
PS C:\> Set-SCOMMaintenanceMode -MaintenanceModeEntry $MMEntry -EndTime $NewEndTime -Comment "Adding 30 minutes to the end time."

Cet exemple étend le mode de maintenance pour un serveur spécifié. La première commande obtient l’instance de classe nommée Server01.Contoso.com, puis la stocke dans la variable $Instance.

La deuxième commande obtient l’entrée en mode maintenance de l’instance de classe stockée dans la variable $Instance et stocke l’entrée dans la variable $MMEntry.

La troisième commande crée un objet DateTime pendant 30 minutes à l’avenir, puis le stocke dans la variable $NewEndTime.

La quatrième commande met à jour la session du mode maintenance pour l’entrée en mode maintenance stockée dans la variable $MMEntry vers l’objet DateTime stocké dans la variable $NewEndTime et ajoute un commentaire.

Paramètres

-Comment

Spécifie un commentaire pour l’entrée en mode maintenance.

Type:String
Position:3
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

-EndTime

Spécifie quand le mode maintenance se termine en tant qu’objet DateTime. Une ressource ne peut pas être en mode maintenance pendant moins de cinq minutes. Pour obtenir un objet DateTime, utilisez l’applet de commande Get-Date . Pour plus d’informations, tapez Get-Help Get-Date.

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

-MaintenanceModeEntry

Spécifie un tableau d’objets MaintenanceWindow. Pour obtenir un objet MaintenanceWindow, utilisez l’applet de commande Get-SCOMMaintenanceMode .

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

-PassThru

Indique que l’applet de commande crée ou modifie un objet qu’une commande peut utiliser dans le pipeline. Par défaut, cette applet de commande ne génère aucune sortie.

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

-Reason

Spécifie une raison pour le mode de maintenance. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • PlannedOther
  • Non planifiéOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Type:MaintenanceModeReason
Position:4
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