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.

Sintaxe

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.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:DateTime
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:MonitoringObject[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Reason

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

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Tipo:MaintenanceModeReason
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False