Compartilhar via

Edit-SCOMMaintenanceSchedule

  • Referência
Módulo:
OperationsManager

Edita um agendamento de manutenção existente.

Syntax

Edit-SCOMMaintenanceSchedule
    [-ScheduleId] <Guid>
    [[-Name] <String>]
    [[-Recursive] <Boolean>]
    [[-Enabled] <Boolean>]
    [[-MonitoringObjects] <Guid[]>]
    [[-ActiveStartTime] <DateTime>]
    [[-ActiveEndDate] <DateTime>]
    [[-Duration] <Int32>]
    [[-ReasonCode] <MaintenanceModeReason>]
    [[-Comments] <String>]
    [[-FreqType] <Int32>]
    [[-FreqInterval] <Int32>]
    [[-FreqRecurrenceFactor] <Int32>]
    [[-FreqRelativeInterval] <Int32>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Edit-SCOMMaintenanceSchedule edita um agendamento de manutenção existente. No entanto, não é possível editar um agendamento que esteja ativo no momento.

Quando um recurso está no modo de manutenção, o Operations Manager suprime alertas, notificações, regras, monitores, respostas automáticas, alterações de estado e novos alertas. Um agendamento de manutenção pode ser usado para agendar um conjunto de recursos para entrar no modo de manutenção.

Você pode usar esse cmdlet para editar agendamentos a serem executados uma vez, diariamente, semanalmente ou mensalmente em um determinado dia ou dia da semana. Você deve passar a ScheduleId de uma agenda existente que deseja editar. Todos os outros parâmetros são opcionais; os parâmetros especificados são substituídos.

Por padrão, esse cmdlet usa a conexão persistente ativa com um grupo de gerenciamento. Use o parâmetro SCSession para especificar uma conexão persistente diferente. Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential . Para obter mais informações, digite Get-Help about_OpsMgr_Connections.

Exemplos

1: Editar um modo de manutenção do System Center Operations Manager agendado usando a ID

PS C:\>Edit-SCOMMaintenanceSchedule -ScheduleId "32AAB279-3670-ED11-9626-00155D012405" -Enabled 1

Edita o Agendamento do Modo de Manutenção com a ID 32AAB279-3670-ED11-9626-00155D012405.

2: Editar um modo de manutenção do System Center Operations Manager agendado usando seu nome

PS C:\>Edit-SCOMMaintenanceSchedule -Name "Test" -Enabled 1

Edita o Agendamento do Modo de Manutenção com o nome.

Parâmetros

-ActiveEndDate

Especifica a data de término e a hora de término em que o agendamento será interrompido. Se você não especificar esse parâmetro, o agendamento continuará sendo executado até que ele seja excluído ou desabilitado.

Por exemplo, se você quiser criar um agendamento que deve terminar em 1º de maio de 2016 às 9h, especifique "01-05-2016 09:00:00" como ActiveEndDate. Você pode passar uma cadeia de caracteres especificando a hora desejada no horário local. No entanto, se você quiser especificar uma hora UTC, precisará especificar um objeto DateTime com DateTimeKind definido como UTC.

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

-ActiveStartTime

Especifica a data de início e a hora em que o agendamento deve ficar ativo. Por exemplo, se você quiser um agendamento que deve começar a partir de 1º de maio de 2016 e deve ser executado às 9h, especifique "01-05-2016 09:00:00" como ActiveStartTime. Você pode passar uma cadeia de caracteres especificando a hora desejada no horário local. No entanto, se você quiser especificar uma hora UTC, precisará especificar um objeto DateTime com o DateTimeKind.

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

-Comments

Especifica qualquer comentário legível para um agendamento de manutenção.

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

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.). O serviço de Acesso a Dados do System Center deve estar ativo no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão do grupo de gerenciamento atual.

Type:String[]
Position:Named
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

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential. Se você especificar um computador no parâmetro ComputerName , use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

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

-Duration

Especifica a duração do agendamento de manutenção. A duração de um agendamento de manutenção é a hora para a qual o agendamento de manutenção durará a cada vez.

Type:Int32
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

Indica se o agendamento será habilitado ou desabilitado após a edição. Se você definir isso como false, o agendamento será desabilitado. Você também pode usar o Enable-SCOMMaintenanceSchedule e Disable-SCOMMaintenanceSchedule para fazer isso.

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

-FreqInterval

Especifica o dia em que o trabalho é executado. Isso será obrigatório se o agendamento for diferente do agendamento OnceRecurrence. O valor depende do valor de FreqType , conforme indicado na lista a seguir:

  • 1 (uma vez). O intervalo de frequência não é utilizado.
  • 4 (diariamente). Todos os dias de intervalo de frequência.
  • 8 (semanal). O parâmetro FreqInterval é um ou mais dos seguintes (combinado com um operador lógico OR):

---- 1 = domingo ---- 2 = segunda-feira ---- 4 = terça-feira ---- 8 = quarta-feira ---- 16 = quinta-feira ---- 32 = sexta-feira ---- 64 = sábado

  • 16 (mensal). No dia do intervalo de frequência do mês.
  • 32 (relativo mensal). O parâmetro FreqInterval é um dos seguintes valores:

---- 1 = domingo ---- 2 = segunda-feira ---- 3 = terça-feira ---- 4 = quarta-feira ---- 5 = quinta-feira ---- 6 = sexta-feira ---- 7 = sábado ---- 8 = Dia ---- 9 = Dia da semana ---- 10 = dia de fim de semana

Type:Int32
Position:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRecurrenceFactor

Número de semanas ou meses entre a execução agendada do trabalho. FreqRecurrenceFactor será usado somente se o parâmetro FreqType estiver definido como 8, 16 ou 32. O parâmetro FreqRecurrenceFactor é um inteiro, com um valor padrão de 0.

Type:Int32
Position:12
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRelativeInterval

Especifica o agendamento quando o parâmetro FreqType é definido como 32 (relativo mensal). Esse parâmetro pode usar um dos valores a seguir:

  • 1 (Primeiro)
  • 2 (Segundo)
  • 4 (Terceiro)
  • 8 (quarto)
  • 16 (Último)
Type:Int32
Position:13
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqType

Especifica quando o trabalho deve ser executado. Esse parâmetro pode usar um dos valores a seguir:

  • 1 (uma vez)
  • 4 (diariamente)
  • 8 (semanalmente).
  • 16 (mensalmente)
  • 32 (mensal, em relação ao parâmetro FreqInterval).
Type:Int32
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitoringObjects

Especifica uma matriz de GUIDs que representam objetos de monitoramento que esse cmdlet coloca no modo de manutenção. Especifica uma matriz de GUIDS de objetos de monitoramento que é colocada no modo de manutenção. Para especificar um objeto de monitoramento que o agendamento coloca no modo de manutenção, você deve passar o atributo ID do objeto de monitoramento. Se você quiser manter alguns dos membros existentes, eles também deverão ser especificados.

Você pode especificar um ou mais objetos de monitoramento para um agendamento. No entanto, você não pode editar um agendamento que não tenha nenhum objeto de monitoramento.

Type:Guid[]
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome da agenda.

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

-ReasonCode

Especifica o código de motivo para um agendamento de manutenção que especifica o motivo da janela de manutenção.

Type:MaintenanceModeReason
Accepted values:PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Recursive

Indica que o agendamento é aplicável ao recurso de nível superior ou a todos os recursos contidos também. Se você definir esse parâmetro como false, somente o recurso especificado entrará no modo de manutenção quando o agendamento for executado. Se isso for definido como true, o recurso especificado e todos os recursos que têm uma relação de contenção com esse recurso também entrarão no modo de manutenção.

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

-ScheduleId

Especifica o GUID do agendamento que este cmdlet edita.

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Especifica uma matriz de objetos Connection .

Type:Connection[]
Position:Named
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