Partager via

New-SCOMMaintenanceSchedule

  • Référence
Module:
OperationsManager

Crée une planification de maintenance.

Syntax

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

L’applet de commande 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 analyses, les réponses automatiques, les changements d’état et les nouvelles alertes. Une planification de maintenance peut être utilisée pour planifier un ensemble de ressources en mode maintenance.

Vous pouvez utiliser cette applet de commande pour créer des planifications qui s’exécutent une fois, quotidiennement, hebdomadairement ou mensuellement 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 permanente 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, voir 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, pour une durée de 240 minutes, en cours d’exécution 1 seule 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 les objets de surveillance associés : Agent01.contoso.local, à partir de 01h00 et d’une durée de 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 les objets de surveillance associés : Agent01.contoso.local, commençant à 02h00 et d’une durée de 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 d’une durée de 180 minutes.

Paramètres

-ActiveEndDate

Spécifie la date de fin et l’heure de fin à laquelle la planification doit cesser de s’exécuter. Si ce paramètre n’est pas spécifié, la planification continue de s’exécuter à jamais (ou jusqu’à ce qu’elle soit supprimée ou désactivée).

Par instance, si vous souhaitez créer une planification qui doit se terminer le 1er mai 2016 à 09h00, 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 dateTimeKind défini sur UTC.

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

-ActiveStartTime

Spécifie la date de début et l’heure à laquelle la planification doit être active. Par instance, si vous souhaitez créer une planification qui doit commencer à partir du 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 dateTimeKind défini sur UTC.

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

-Comments

Spécifie tous les commentaires lisibles par l’utilisateur pour une planification de maintenance.

Type:String
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
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

-Credential

Spécifie un objet PSCredential pour la connexion du groupe d’administration. Pour obtenir un objet PSCredential, utilisez l'applet de commande Get-Credential. Pour plus d’informations, tapez Get-Help Get-Credential. 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Duration

Spécifie la durée de la planification de maintenance. La durée d’une planification de maintenance est la durée de la planification de la maintenance.

Type:Int32
Aliases:DurationInMinutes
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqInterval

Spécifie le moment où 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 (par jour). Tous les jours d’intervalle de fréquence.
  • 8 (hebdomadaire). Le paramètre FreqInterval est l’un ou plusieurs des éléments suivants (combinés à un opérateur logique OR) :
    • 1 - Dimanche
    • 2 - Lundi
    • 4 - Mardi
    • 8 - Mercredi
    • 16 - Jeudi
    • 32 - Vendredi
    • 64 - Samedi
  • 16 (mensuel). Jour de l’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 - Jour de la semaine
    • 10 - Jour du week-end
Type:Int32
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRecurrenceFactor

Nombre de semaines ou de mois devant s'écouler entre chaque 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 la valeur par défaut 0.

Type:Int32
Position:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRelativeInterval

Jour d'exécution du travail. Cela est obligatoire si la planification est autre que la planification OnceRecurrence . La valeur dépend de la valeur de FreqType.

Ce paramètre peut être l’une des valeurs suivantes :

  • 1 (Premier)
  • 2 (Deuxième)
  • 4 (Troisième)
  • 8 (Quatrième)
  • 16 (Dernier)
Type:Int32
Position:12
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqType

Spécifie le moment où le travail doit être exécuté. Les valeurs valides pour ce paramètre sont :

  • 1 (une fois)
  • 4 (quotidiennement)
  • 8 (hebdomadairement)
  • 16 (mensuellement)
  • 32 (mensuel, par rapport au paramètre FreqInterval)
Type:Int32
Position:9
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MonitoringObjects

Spécifie un tableau de GUID d’objets de surveillance qui seront mis en mode maintenance. Pour spécifier un objet de surveillance que la planification créée mettra en mode maintenance, vous devez passer 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 de planification sans objet de surveillance.

Type:Guid[]
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 valides pour ce paramètre sont :

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • UnplannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Type:MaintenanceModeReason
Accepted values:PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:7
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 lors de l’exécution de la planification. Si cette valeur est définie sur true, la ressource spécifiée et toutes les ressources qui ont une relation de confinement avec cette ressource passent également en mode maintenance.

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

-SCSession

Spécifie un tableau d’objets Connection .

Type:Connection[]
Position:Named
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