New-SCOMMaintenanceSchedule

Sintaxe

Default (Predefinição)

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

Exemplos

Exemplo 1: Adicionar objeto de computador do Windows a uma nova agenda 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 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 3: Criar uma agenda 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 4: Criar uma agenda 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

Parâmetros

-ActiveEndDate

Especifica a data de término e a hora de término em que a agenda deve parar de ser executada. Se esse parâmetro não for especificado, o agendamento continuará a ser executado para sempre (ou até que seja excluído ou desativado).

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveStartTime

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Comments

Especifica quaisquer comentários legíveis por humanos para um cronograma de manutenção.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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 atual do grupo de gerenciamento.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Duration

Especifica a duração do cronograma de manutenção. A duração de um programa de manutenção é o tempo durante o qual o programa de manutenção irá durar.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Enabled

Indica se a agenda será habilitada ou desabilitada após a criação. Se você definir isso como false, o agendamento será criado, mas será desativado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-FreqInterval

Especifica quando o trabalho deve ser executado. Este parâmetro pode ser um dos seguintes valores:

• 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.
  
  • 1 - Domingo
    
  • 2 - Segunda-feira
    
  • 3 - Terça-feira
    
  • 4 - Quarta-feira
    
  • 5 - Quinta-feira
    
  • 6 - Sexta-feira
    
  • 7 - Sábado
    
• 32 (mensal relativo). O parâmetro FreqInterval é um dos seguintes valores:
  
  • 8 - Dia
    
  • 9 - Dia da semana
    
  • 10 - Dia de fim de semana
    

Propriedades dos parâmetros

Conjuntos de parâmetros

-FreqRecurrenceFactor

Número de semanas ou meses entre a execução programada do trabalho. FreqRecurrenceFactor é 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-FreqRelativeInterval

Dia em que o trabalho é executado. Isso é obrigatório se o cronograma for diferente do cronograma OnceRecurrence . O valor depende do valor de FreqType.

Este parâmetro pode ser um dos seguintes valores:

• 1 (Primeiro)
• 2 (Segundo)
• 4 (Terceira)
• 8 (Quarta)
• 16 (Último)

Propriedades dos parâmetros

Conjuntos de parâmetros

-FreqType

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

• 1 (uma vez)
• 4 (diários)
• 8 (semanal)
• 16 (mensal)
• 32 (Mensal, relativo ao parâmetro FreqInterval)

Propriedades dos parâmetros

Conjuntos de parâmetros

-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 uma agenda. No entanto, você não pode criar uma agenda sem qualquer objeto de monitoramento.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

Especifica o nome da agenda criada por esse cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ReasonCode

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

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

• Outro Planeado
• Não planeadoOutro
• Manutenção de Hardware Programada
• Não planeado Manutenção de Hardware
• Instalação de Hardware Planeada
• Instalação de Hardware Não Planeada
• ReconfiguraçãoPlaneadaDoSistemaOperativo
• Reconfiguração Não Planeada do Sistema Operativo
• Manutenção Planeada de Aplicações
• Manutenção Não Planeada de Aplicações
• Instalação de Aplicação
• AplicativoSem resposta
• AplicaçãoInstável
• Problema de Segurança
• Perda de Conectividade de Rede

Propriedades dos parâmetros

Conjuntos de parâmetros

-Recursive

Indica se o cronograma é 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-SCSession

Especifica uma matriz de objetos Connection .

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

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

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Ligações Relacionadas

• Disable-SCOMMaintenanceSchedule
• Edit-SCOMMaintenanceSchedule
• Enable-SCOMMaintenanceSchedule
• Get-SCOMMaintenanceSchedule
• Remove-SCOMMaintenanceSchedule
• Stop-SCOMMaintenanceSchedule
• Update-SCOMMaintenanceSchedule
• Get-SCOMManagementGroup