Partilhar via

Set-SCOMMaintenanceMode

  • Referência
Módulo:
OperationsManager

Atualizações entradas do modo de manutenção ativa.

Syntax

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. Pode utilizar este cmdlet para atualizar apenas 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.

Pode alterar o comentário ou o motivo do modo de manutenção. Utilize o cmdlet Get-SCOMMaintenanceMode para obter uma entrada do modo de manutenção para atualizar. Especifique um fim para a janela de manutenção.

Exemplos

Exemplo 1: Atualizar entradas do modo de manutenção ativa para recursos num 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 para um dia no futuro e, em seguida, armazena-o na variável $NewEndTime.

O segundo comando obtém todas as instâncias de classe no domínio Contoso.com e utiliza o operador de pipeline (|) para transmitir os objetos da instância de classe para o cmdlet Get-SCOMMaintenanceMode , que obtém objetos de entrada do modo de manutenção. O comando utiliza o operador de pipeline para transmitir estes objetos ao cmdlet Set-SCOMMaintenanceMode . Este cmdlet atualiza a hora de fim de cada objeto para o objeto DateTime armazenado na variável $NewEndTime. O comando também inclui um comentário para cada entrada do 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 expande o modo de manutenção para um servidor especificado. O primeiro comando obtém a instância de classe com o nome Server01.Contoso.com e, em seguida, armazena-a na variável $Instance.

O segundo comando obtém a entrada do 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 durante 30 minutos no futuro e, em seguida, armazena-o na variável $NewEndTime.

O quarto comando atualiza a sessão do modo de manutenção para a entrada do 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.

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

-Confirm

Solicita a 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 durante menos de cinco minutos. Para obter um objeto DateTime , utilize o cmdlet Get-Date . Para mais informações, insira Get-Help Get-Date.

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

-MaintenanceModeEntry

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

Type:MaintenanceWindow[]
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 utilizar no pipeline. Por predefinição, este cmdlet não gera quaisquer dados.

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 este 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

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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