Partager via

Start-SCOMMaintenanceMode

  • Référence
Module:
OperationsManager

Place un objet en mode maintenance et crée une entrée de mode maintenance active.

Syntaxe

Start-SCOMMaintenanceMode
     [-Instance] <MonitoringObject[]>
     [-EndTime] <DateTime>
     [[-Comment] <String>]
     [[-Reason] <MaintenanceModeReason>]
     [-PassThru]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

L’applet de commande Start-SCOMMaintenanceMode place un objet surveillé, tel qu’un ordinateur ou une application distribuée, en mode maintenance et crée une entrée de mode de maintenance active. 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.

Spécifiez une instance de classe à mettre en mode maintenance et une heure de fin pour la fenêtre de maintenance. Vous pouvez également inclure un commentaire et une raison du mode de maintenance. Vous pouvez utiliser l’applet de commande Set-SCOMMaintenanceMode pour mettre à jour une entrée en mode maintenance active et utiliser l’applet de commande Get-SCOMMaintenanceMode get active et inactive.

Exemples

Exemple 1 : Placer une ressource en mode maintenance

PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $Time = ((Get-Date).AddMinutes(10))
PS C:\> Start-SCOMMaintenanceMode -Instance $Instance -EndTime $Time -Comment "Applying software update." -Reason "SecurityIssue"

Cet exemple montre comment mettre une ressource en mode maintenance pendant dix minutes. La première commande obtient l’instance de classe nommée Server01.Contoso.com à l’aide de l’applet de commande Get-SCOMClassInstance .

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

La troisième commande place la ressource définie par l’objet stocké dans la variable $Instance en mode maintenance. Le mode maintenance se termine au moment stocké dans la variable $Time. La commande inclut une raison pour le mode maintenance et 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 de 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

-Instance

Spécifie un tableau d’objets de surveillance qui représentent des instances. Pour obtenir des objets de surveillance, utilisez l’applet de commande Get-SCOMClassInstance .

Ce paramètre accepte également les objets de groupe. Pour obtenir un objet de groupe, utilisez l’applet de commande Get-SCOMGroup Get-SCOMGroup.

Type:MonitoringObject[]
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