Compartilhar via


Set-SCOMMaintenanceMode

Atualiza entradas do modo de manutenção ativa.

Sintaxe

Default (Padrão)

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

Description

O cmdlet Set-SCOMMaintenanceMode atualiza as entradas do modo de manutenção ativa. Você pode usar esse cmdlet para atualizar somente entradas ativas.

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.

Você pode alterar o comentário ou o motivo do modo de manutenção. Use o cmdlet Get-SCOMMaintenanceMode para obter uma entrada de modo de manutenção a ser atualizada. Especifique um fim para a janela de manutenção.

Exemplos

Exemplo 1: atualizar entradas do modo de manutenção ativa para recursos em um domínio

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

Este exemplo atualiza todas as entradas do modo de manutenção ativa para um domínio especificado. O primeiro comando cria um objeto DateTime por um dia no futuro e, em seguida, o armazena na variável $NewEndTime.

O segundo comando obtém todas as instâncias de classe no domínio Contoso.com e usa o operador de pipeline (|) para passar os objetos de instância de classe para o cmdlet Get-SCOMMaintenanceMode , que obtém objetos de entrada do modo de manutenção. O comando usa o operador de pipeline para passar esses objetos para o cmdlet Set-SCOMMaintenanceMode. Esse cmdlet atualiza a hora de término de cada objeto para o objeto DateTime armazenado na variável $NewEndTime. O comando também inclui um comentário para cada entrada de modo de manutenção atualizada.

Exemplo 2: atualizar a entrada do modo de manutenção para um 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."

Este exemplo estende o modo de manutenção para um servidor especificado. O primeiro comando obtém a instância de classe chamada Server01.Contoso.com e, em seguida, a armazena na variável $Instance.

O segundo comando obtém a entrada de modo de manutenção da instância de classe armazenada na variável $Instance e armazena a entrada na variável $MMEntry.

O terceiro comando cria um objeto DateTime por 30 minutos no futuro e o armazena na variável $NewEndTime.

O quarto comando atualiza a sessão de modo de manutenção para a entrada de modo de manutenção armazenada na variável $MMEntry para o objeto DateTime armazenado na variável $NewEndTime e adiciona 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

-MaintenanceModeEntry

Especifica uma matriz de objetos MaintenanceWindow. Para obter um objeto MaintenanceWindow, use o cmdlet Get-SCOMMaintenanceMode.

Propriedades do parâmetro

Tipo:

MaintenanceWindow[]

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.