Edit-SCOMMaintenanceSchedule
Edita una programación de mantenimiento existente.
Syntax
Edit-SCOMMaintenanceSchedule
[-ScheduleId] <Guid>
[[-Name] <String>]
[[-Recursive] <Boolean>]
[[-Enabled] <Boolean>]
[[-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
El cmdlet Edit-SCOMMaintenanceSchedule edita una programación de mantenimiento existente. Sin embargo, no se puede editar una programación que esté activa actualmente.
Cuando un recurso está en modo de mantenimiento, Operations Manager suprime las alertas, las notificaciones, las reglas, los monitores, las respuestas automáticas, los cambios de estado y las nuevas alertas. Se puede usar una programación de mantenimiento para programar un conjunto de recursos para entrar en modo de mantenimiento.
Puede usar este cmdlet para editar programaciones para que se ejecuten una vez, diaria, semanal o mensualmente en un día determinado o un día de la semana. Debe pasar el valor scheduleId de una programación existente que desee editar. Todos los demás parámetros son opcionales; los parámetros especificados se sobrescriben.
De forma predeterminada, este cmdlet usa la conexión persistente activa a un grupo de administración.
Use el parámetro SCSession para especificar una conexión persistente diferente.
Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential .
Para obtener más información, escriba Get-Help about_OpsMgr_Connections
.
Ejemplos
1: Editar un modo de mantenimiento de System Center Operations Manager programado mediante el identificador
PS C:\>Edit-SCOMMaintenanceSchedule -ScheduleId "32AAB279-3670-ED11-9626-00155D012405" -Enabled 1
Edita la programación del modo de mantenimiento con el identificador 32AAB279-3670-ED11-9626-00155D012405.
2: Editar un modo de mantenimiento de System Center Operations Manager programado con su nombre
PS C:\>Edit-SCOMMaintenanceSchedule -Name "Test" -Enabled 1
Edita la programación del modo de mantenimiento con el nombre .
Parámetros
-ActiveEndDate
Especifica la fecha de finalización y la hora de finalización en que se detendrá la programación. Si no especifica este parámetro, la programación continuará ejecutándose hasta que se elimine o deshabilite.
Por ejemplo, si desea crear una programación que debe finalizar el 1 de mayo de 2016 a las 9:00 a.m., debe especificar "01-05-2016 09:00:00" como ActiveEndDate. Puede pasar una cadena que especifique la hora que desee en la hora local. Sin embargo, si desea especificar una hora UTC, debe especificar un objeto DateTime con dateTimeKind establecido en UTC.
Type: | DateTime |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ActiveStartTime
Especifica la fecha de inicio y la hora en que la programación debe estar activa. Por ejemplo, si desea una programación que debe comenzar desde el 1 de mayo de 2016 y debe ejecutarse a las 9:00 a.m., debe especificar "01-05-2016 09:00:00" como ActiveStartTime. Puede pasar una cadena que especifique la hora que desee en la hora local. Sin embargo, si desea especificar una hora UTC, debe especificar un objeto DateTime con DateTimeKind.
Type: | DateTime |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comments
Especifica cualquier comentario legible para una programación de mantenimiento.
Type: | String |
Position: | 9 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres NetBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.). El servicio de acceso a datos de System Center debe estar activo en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Especifica un objeto PSCredential para la conexión del grupo de administración.
Para obtener un objeto PSCredential, use el cmdlet Get-Credential.
Para obtener más información, escriba Get-Help Get-Credential
. Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo.
El valor predeterminado es el usuario actual.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Duration
Especifica la duración de la programación de mantenimiento. La duración de una programación de mantenimiento es la hora para la que la programación de mantenimiento durará cada vez.
Type: | Int32 |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enabled
Indica si la programación se habilitará o deshabilitará al editarse. Si establece esto en false, la programación se deshabilitará. También puede usar el Enable-SCOMMaintenanceSchedule y Disable-SCOMMaintenanceSchedule para hacerlo.
Type: | Boolean |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FreqInterval
Especifica el día en que se ejecuta el trabajo. Esto es obligatorio si la programación es algo distinto de la programación OnceRecurrence. El valor depende del valor de FreqType como se indica en la lista siguiente:
- 1 (una vez). El intervalo de frecuencia no se usa.
- 4 (diario). Cada intervalo de frecuencia días.
- 8 (semanal). El parámetro FreqInterval es uno o varios de los siguientes (combinados con un operador lógico OR):
---- 1 = domingo ---- 2 = lunes ---- 4 = martes ---- 8 = miércoles ---- 16 = jueves ---- 32 = viernes ---- 64 = sábado
- 16 (mensual). En el intervalo de frecuencia del mes.
- 32 (relativo mensual). El parámetro FreqInterval es uno de los siguientes valores:
---- 1 = Domingo ---- 2 = Lunes ---- 3 = Martes ---- 4 = Miércoles ---- 5 = Jueves ---- 6 = Viernes ---- 7 = Sábado ---- 8 = Día ---- 9 = Día ---- 10 = Día de fin de semana
Type: | Int32 |
Position: | 11 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FreqRecurrenceFactor
Número de semanas o meses entre la ejecución programada del trabajo. FreqRecurrenceFactor solo se usa si el parámetro FreqType está establecido en 8, 16 o 32. El parámetro FreqRecurrenceFactor es un entero, con un valor predeterminado de 0.
Type: | Int32 |
Position: | 12 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FreqRelativeInterval
Especifica la programación cuando el parámetro FreqType se establece en 32 (relativo mensual). Este parámetro puede establecerse con uno de los siguientes valores:
- 1 (primero)
- 2 (Segundo)
- 4 (Tercero)
- 8 (Cuarto)
- 16 (Último)
Type: | Int32 |
Position: | 13 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FreqType
Especifica cuándo se va a ejecutar el trabajo. Este parámetro puede establecerse con uno de los siguientes valores:
- 1 (una vez)
- 4 (diariamente)
- 8 (semanalmente)
- 16 (mensualmente)
- 32 (Mensual, relativo al parámetro FreqInterval).
Type: | Int32 |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MonitoringObjects
Especifica una matriz de GUID que representa los objetos de supervisión que este cmdlet coloca en modo de mantenimiento. Especifica una matriz de GUIDS de objetos de supervisión que se coloca en modo de mantenimiento. Para especificar un objeto de supervisión que la programación coloca en modo de mantenimiento, debe pasar el atributo ID del objeto de supervisión. Si desea conservar algunos de los miembros existentes, también deben especificarse.
Puede especificar uno o varios objetos de supervisión para una programación. Sin embargo, no se puede editar una programación que no tenga ningún objeto de supervisión.
Type: | Guid[] |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre de la programación.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReasonCode
Especifica el código de motivo de una programación de mantenimiento que especifica el motivo de la ventana de mantenimiento.
Type: | MaintenanceModeReason |
Accepted values: | PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Recursive
Indica que la programación es aplicable al recurso de nivel superior o también a todos los recursos contenidos. Si establece este parámetro en false, solo el recurso especificado entrará en modo de mantenimiento cuando se ejecute la programación. Si se establece en true, el recurso especificado y todos los recursos que tienen una relación de contención con este recurso también entrarán en modo de mantenimiento.
Type: | Boolean |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleId
Especifica el GUID de la programación que edita este cmdlet.
Type: | Guid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
Especifica una matriz de objetos Connection .
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |