Partager via

Start-SCOMMaintenanceMode

  • Référence
Module:
OperationsManager

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

Syntax

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. Quand 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 changements d’état et les nouvelles alertes.

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

Exemples

Exemple 1 : Mettre 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 place une ressource en mode maintenance pendant dix minutes. La première commande obtient la classe instance 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 à l’heure stockée 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 mode maintenance.

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

-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, voir Get-Help Get-Date.

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

-Instance

Spécifie un tableau d’objets d’analyse 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 .

Type:MonitoringObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 aucun résultat.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Reason

Spécifie une raison pour le mode maintenance. Les valeurs valides pour ce paramètre sont :

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