Share via


Start-SCOMMaintenanceMode

Coloca un objeto en modo de mantenimiento y crea una entrada de modo de mantenimiento activo.

Syntax

Start-SCOMMaintenanceMode
     [-Instance] <MonitoringObject[]>
     [-EndTime] <DateTime>
     [[-Comment] <String>]
     [[-Reason] <MaintenanceModeReason>]
     [-PassThru]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

El cmdlet Start-SCOMMaintenanceMode coloca un objeto supervisado, como un equipo o una aplicación distribuida, en modo de mantenimiento y crea una entrada de modo de mantenimiento activo. Cuando un recurso está en modo de mantenimiento, System Center - Operations Manager suprime alertas, notificaciones, reglas, monitores, respuestas automáticas, cambios de estado y nuevas alertas.

Especifique una instancia de clase para poner en modo de mantenimiento y una hora de finalización para la ventana de mantenimiento. También puede incluir un comentario y un motivo para el modo de mantenimiento. Puede usar el cmdlet Set-SCOMMaintenanceMode para actualizar una entrada de modo de mantenimiento activo y usar el cmdlet Get-SCOMMaintenanceMode para obtener entradas activas e inactivas.

Ejemplos

Ejemplo 1: Colocar un recurso en modo de mantenimiento

PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $Time = ((Get-Date).AddMinutes(10))
PS C:\> Start-SCOMMaintenanceMode -Instance $Instance -EndTime $Time -Comment "Applying software update." -Reason "SecurityIssue"

En este ejemplo se coloca un recurso en modo de mantenimiento durante diez minutos. El primer comando obtiene la instancia de clase denominada Server01.Contoso.com mediante el cmdlet Get-SCOMClassInstance .

El segundo comando crea un objeto DateTime durante diez minutos en el futuro y, a continuación, lo almacena en la variable $Time.

El tercer comando coloca el recurso definido por el objeto almacenado en la variable $Instance en modo de mantenimiento. El modo de mantenimiento finaliza en el momento almacenado en la variable $Time. El comando incluye un motivo para el modo de mantenimiento y un comentario.

Parámetros

-Comment

Especifica un comentario para la entrada del modo de mantenimiento.

Type:String
Position:3
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

-EndTime

Especifica cuándo finaliza el modo de mantenimiento, como un objeto DateTime . Un recurso no puede estar en modo de mantenimiento durante menos de cinco minutos. Para obtener un objeto DateTime , use el cmdlet Get-Date . Para obtener más información, escriba Get-Help Get-Date.

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

-Instance

Especifica una matriz de objetos de supervisión que representan instancias. Para obtener objetos de supervisión, use el cmdlet Get-SCOMClassInstance .

Este parámetro también acepta objetos de grupo. Para obtener un objeto de grupo, use el cmdlet Get-SCOMGroup .

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

-PassThru

Indica que el cmdlet crea o modifica un objeto que un comando puede usar en la canalización. De forma predeterminada, este cmdlet no genera ningún resultado.

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

-Reason

Especifica un motivo para el modo de mantenimiento. Los valores permitidos para este parámetro son los siguientes:

  • 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

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