Compartilhar via

Start-SCOMMaintenanceMode

  • Referência
Módulo:
OperationsManager

Coloca um objeto no modo de manutenção e cria uma entrada de modo de manutenção ativa.

Syntax

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

Description

O cmdlet Start-SCOMMaintenanceMode coloca um objeto monitorado, como um computador ou aplicativo distribuído, no modo de manutenção e cria uma entrada de modo de manutenção ativa. Quando um recurso está no modo de manutenção, o System Center – Operations Manager suprime alertas, notificações, regras, monitores, respostas automáticas, alterações de estado e novos alertas.

Especifique uma instância de classe a ser colocada no modo de manutenção e uma hora de término para a janela de manutenção. Você também pode incluir um comentário e um motivo para o modo de manutenção. Você pode usar o cmdlet Set-SCOMMaintenanceMode para atualizar uma entrada de modo de manutenção ativa e usar o cmdlet Get-SCOMMaintenanceMode para obter entradas ativas e inativas.

Exemplos

Exemplo 1: colocar um recurso no modo de manutenção

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"

Este exemplo coloca um recurso no modo de manutenção por dez minutos. O primeiro comando obtém a instância de classe chamada Server01.Contoso.com usando o cmdlet Get-SCOMClassInstance .

O segundo comando cria um objeto DateTime por dez minutos no futuro e o armazena na variável $Time.

O terceiro comando coloca o recurso definido pelo objeto armazenado na variável $Instance no modo de manutenção. O modo de manutenção termina no momento armazenado na variável $Time. O comando inclui um motivo para o modo de manutenção e um comentário.

Parâmetros

-Comment

Especifica um comentário para a entrada do modo de manutenção.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-EndTime

Especifica quando o modo de manutenção termina, como um objeto DateTime . Um recurso não pode estar no modo de manutenção por menos de cinco minutos. Para obter um objeto DateTime , use o cmdlet Get-Date . Para obter mais informações, digite Get-Help Get-Date.

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

-Instance

Especifica uma matriz de objetos de monitoramento que representam instâncias. Para obter objetos de monitoramento, use o cmdlet Get-SCOMClassInstance .

Esse parâmetro também aceita objetos de grupo. Para obter um objeto de grupo, use o cmdlet Get-SCOMGroup .

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

-PassThru

Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, este cmdlet não gera saída.

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

-Reason

Especifica um motivo para o modo de manutenção. Os valores aceitáveis para esse parâmetro são:

  • 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

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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