Compartilhar via

Start-SCOMMaintenanceMode

Módulo:
OperationsManager Module

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

Sintaxe

Default (Padrão) 

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

MonitoringObject[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Propriedades do parâmetro

Tipo:MaintenanceModeReason
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.