New-SCOMMaintenanceSchedule
Crée une planification de maintenance.
Syntaxe
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 -EnabledExemple 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 -EnabledExemple 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 -EnabledExemple 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 -EnabledExemple 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Comments
Spécifie tous les commentaires lisibles par l’utilisateur pour une planification de maintenance.
| Type: | String |
| Position: | 8 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous demande une confirmation 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 |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Alias: | DurationInMinutes |
| Position: | 6 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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
- 1 - Dimanche
- 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
- 1 - Dimanche
- 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
- 8 - Jour
| Type: | Int32 |
| Position: | 10 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom de la planification créée par cette applet de commande.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeurs acceptées: | PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity |
| Position: | 7 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SCSession
Spécifie un tableau d’objets Connection .
| Type: | Connection[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| 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 |