Compartilhar via

New-SCOMMaintenanceSchedule

  • Referência
Módulo:
OperationsManager

Cria um agendamento de manutenção.

Syntax

New-SCOMMaintenanceSchedule
   [-Name] <String>
   [-Recursive]
   [-Enabled]
   [-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 New-SCOMMaintenanceSchedule cria um agendamento de manutenção.

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 criar agendas que são executadas uma vez, diariamente, semanalmente ou mensalmente em um determinado dia ou um dia da semana. Esse cmdlet retornará o GUID do agendamento criado.

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

Exemplo 1: Adicionar objeto windows computer em um novo agendamento de manutenção

PS C:\>$windowsComputer = Get-SCOMClass -DisplayName "Windows Computer" | Get-SCOMClassInstance | Where-Object { $_.DisplayName -eq 'Agent01.contoso.local' }
PS C:\>New-SCOMMaintenanceSchedule -Name 'Test Maintenance Schedule' -MonitoringObjects $windowsComputer.Id -ActiveStartTime $((Get-Date).AddMinutes(2)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

Exemplo mostrando como adicionar um Objeto de Computador Windows para um servidor específico: Agent01.contoso.com no novo Agendamento de Manutenção, por uma duração de 240 minutos, executando apenas 1 vez.

Exemplo 2: Criar uma agenda de manutenção diária

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is UTC (Coordinated Universal Time)
PS C:\>$startDate = [DateTime]::SpecifyKind([DateTime]"2024-03-30T01:00:00", [System.DateTimeKind]::Utc)
PS C:\>$durationInMinutes = 90
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Daily Maintenance at 1AM" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 4 -FreqInterval 1 -Enabled

Exemplo mostrando como configurar uma agenda de manutenção diária para um servidor específico e objetos de monitoramento associados: Agent01.contoso.local, começando à 1h e durando 90 minutos.

Exemplo 3: Criar um agendamento de manutenção semanal

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-03-29T02:00:00"
PS C:\>$durationInMinutes = 120
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Weekly Wednesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 8 -FreqInterval 8 -FreqRecurrenceFactor 1 -Enabled

Exemplo mostrando como configurar um agendamento de manutenção semanal todas as quartas-feiras para um servidor específico e objetos de monitoramento associados: Agent01.contoso.local, começando às 2h00 e durando 120 minutos.

Exemplo 4: Criar um agendamento de manutenção mensal

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-04-01T03:00:00"
PS C:\>$durationInMinutes = 180
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Monthly Second Tuesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 32 -FreqInterval 2 -FreqRelativeInterval 2 -FreqRecurrenceFactor 1 -Enabled

Exemplo mostrando como estabelecer um agendamento de manutenção mensal na segunda terça-feira de cada mês para um servidor específico e objetos de monitoramento associados: Agent01.contoso.local, começando às 3h e durando 180 minutos.

Parâmetros

-ActiveEndDate

Especifica a data de término e a hora de término em que o agendamento deve parar de ser executado. Se esse parâmetro não for especificado, o agendamento continuará a ser executado para sempre (ou até que 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, deverá especificar um objeto DateTime com DateTimeKind definido como UTC.

Type:DateTime
Position:5
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 a agenda deve ficar ativa. Por exemplo, se você quiser criar 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 o 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 DateTimeKind definido como UTC.

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

-Comments

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

Type:String
Position:8
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 é o tempo para o qual o agendamento de manutenção durará.

Type:Int32
Aliases:DurationInMinutes
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

Indica se o agendamento será habilitado ou desabilitado após a criação. Se você definir isso como false, o agendamento será criado, mas ele será desabilitado.

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

-FreqInterval

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

  • 1 (uma vez). O intervalo de frequência não é utilizado.
  • 4 (diariamente). Cada intervalo de frequência de dias.
  • 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.
    • 1 - Domingo
    • 2 - Segunda-feira
    • 3 - Terça-feira
    • 4 - Quarta-feira
    • 5 - Quinta-feira
    • 6 - Sexta-feira
    • 7 - Sábado
  • 32 (relativo mensal). O parâmetro FreqInterval é um dos seguintes valores:
    • 8 – Dia
    • 9 – Dia da semana
    • 10 - Dia do fim de semana
Type:Int32
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRecurrenceFactor

Número de semanas ou meses entre execuções agendadas 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:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRelativeInterval

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.

Esse parâmetro pode usar um dos valores a seguir:

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

-FreqType

Especifica quando o trabalho deve ser executado. Os valores aceitáveis para esse parâmetro são:

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

-MonitoringObjects

Especifica uma matriz de GUIDS de objetos de monitoramento que serão colocados no modo de manutenção. Para especificar um objeto de monitoramento que o agendamento criado colocará no modo de manutenção, você deve passar o atributo ID do objeto de monitoramento.

Você pode especificar um ou mais objetos de monitoramento para um agendamento. No entanto, você não pode criar uma agenda sem nenhum objeto de monitoramento.

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

-Name

Especifica o nome da agenda que este cmdlet cria.

Type:String
Position:0
Default value:None
Required:True
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.

Os valores aceitáveis para esse parâmetro são:

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

-Recursive

Indica se o agendamento é aplicável ao recurso de nível superior ou a todos os recursos contidos. Se o parâmetro recursivo for definido 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:SwitchParameter
Position:1
Default value:None
Required:False
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