Compartir a través de

Set-SCOMMaintenanceMode

Módulo:
OperationsManager Module

Actualiza las entradas del modo de mantenimiento activo.

Sintaxis

Default (Es el valor predeterminado). 

Set-SCOMMaintenanceMode
    [-MaintenanceModeEntry] <MaintenanceWindow[]>
    [-PassThru]
    [-EndTime] <DateTime>
    [[-Comment] <String>]
    [[-Reason] <MaintenanceModeReason>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Set-SCOMMaintenanceMode actualiza las entradas del modo de mantenimiento activo. Puede usar este cmdlet para actualizar solo las entradas activas.

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.

Puede cambiar el comentario o el motivo del modo de mantenimiento. Use el cmdlet Get-SCOMMaintenanceMode para obtener una entrada del modo de mantenimiento que se va a actualizar. Especifique un final para la ventana de mantenimiento.

Ejemplos

Ejemplo 1: Actualizar entradas del modo de mantenimiento activo para los recursos de un dominio

PS C:\>$NewEndTime = (Get-Date).addDays(1)
PS C:\> Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode | Set-SCOMMaintenanceMode -EndTime $NewEndTime -Comment "Updating end time."

En este ejemplo se actualizan todas las entradas del modo de mantenimiento activo para un dominio especificado. El primer comando crea un objeto DateTime para un día en el futuro y, a continuación, lo almacena en la variable $NewEndTime.

El segundo comando obtiene todas las instancias de clase del dominio Contoso.com y usa el operador de canalización (|) para pasar los objetos de instancia de clase al cmdlet Get-SCOMMaintenanceMode, que obtiene objetos de entrada del modo de mantenimiento. El comando usa el operador de canalización para pasar estos objetos al cmdlet set-SCOMMaintenanceMode . Este cmdlet actualiza la hora de finalización de cada objeto a la objeto DateTime almacenado en la variable $NewEndTime. El comando también incluye un comentario para cada entrada del modo de mantenimiento actualizado.

Ejemplo 2: Actualización de la entrada del modo de mantenimiento para un recurso especificado

PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $MMEntry = Get-SCOMMaintenanceMode -Instance $Instance
PS C:\> $NewEndTime = (Get-Date).addMinutes(30)
PS C:\> Set-SCOMMaintenanceMode -MaintenanceModeEntry $MMEntry -EndTime $NewEndTime -Comment "Adding 30 minutes to the end time."

En este ejemplo se amplía el modo de mantenimiento de un servidor especificado. El primer comando obtiene la instancia de clase denominada Server01.Contoso.com y, a continuación, la almacena en la variable $Instance.

El segundo comando obtiene la entrada del modo de mantenimiento para la instancia de clase almacenada en la variable $Instance y almacena la entrada en la variable $MMEntry.

El tercer comando crea un objeto DateTime durante 30 minutos en el futuro y, a continuación, lo almacena en la variable $NewEndTime.

El cuarto comando actualiza la sesión del modo de mantenimiento para la entrada del modo de mantenimiento almacenada en la variable $MMEntry a la objeto DateTime almacenado en la variable $NewEndTime y agrega un comentario.

Parámetros

-Comment

Especifica un comentario para la entrada del modo de mantenimiento.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 de . Para obtener más información, escriba Get-Help Get-Date.

Propiedades del parámetro

Tipo:DateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MaintenanceModeEntry

Especifica una matriz de objetos MaintenanceWindow. Para obtener un objeto MaintenanceWindow, use el cmdlet Get-SCOMMaintenanceMode.

Propiedades del parámetro

Tipo:

MaintenanceWindow[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 ninguna salida.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Reason

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

  • PlannedOther
  • No planeadoOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity

Propiedades del parámetro

Tipo:MaintenanceModeReason
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:4
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.