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 |