Edit-SCOMMaintenanceSchedule
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 1Edita 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 1Edita 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 |