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