Partager via

Set-SCOMMaintenanceMode

  • Référence
Module:
OperationsManager

Mises à jour entrées en mode maintenance active.

Syntax

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 actives en mode maintenance. 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 changements d’état et les nouvelles alertes.

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

Exemples

Exemple 1 : Mettre à jour les entrées en mode de 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 dans le futur, 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 passer la classe instance objets à l’applet de commande Get-SCOMMaintenanceMode, qui obtient des 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 de mode de 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 le instance de classe nommé Server01.Contoso.com, puis le stocke dans la variable $Instance.

La deuxième commande obtient l’entrée de mode maintenance pour la classe instance 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 de mode maintenance pour l’entrée de mode de maintenance stockée dans la variable $MMEntry sur l’objet DateTime stocké dans la variable $NewEndTime et ajoute un commentaire.

Paramètres

-Comment

Spécifie un commentaire pour l’entrée du mode de 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

-MaintenanceModeEntry

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

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