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 uma agenda de manutenção existente. No entanto, não pode editar uma agenda que esteja atualmente ativa.
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 utilizado para agendar um conjunto de recursos para entrar no modo de manutenção.
Pode utilizar este cmdlet para editar agendamentos para serem executados uma vez, diariamente, semanalmente ou mensalmente num determinado dia ou dia da semana. Tem de transmitir o ScheduleId de uma agenda existente que pretenda editar. Todos os outros parâmetros são opcionais; os parâmetros especificados são substituídos.
Por predefinição, este cmdlet utiliza a ligação persistente ativa a um grupo de gestão.
Utilize o parâmetro SCSession para especificar uma ligação persistente diferente.
Pode criar uma ligação temporária a um grupo de gestão com os parâmetros ComputerName e Credential .
Para mais informações, insira Get-Help about_OpsMgr_Connections.
Exemplos
1: Editar um modo de manutenção do System Center Operations Manager agendado com o ID
PS C:\>Edit-SCOMMaintenanceSchedule -ScheduleId "32AAB279-3670-ED11-9626-00155D012405" -Enabled 1Edita a Agenda do Modo de Manutenção com o ID 32AAB279-3670-ED11-9626-00155D012405.
2: Editar um modo de manutenção do System Center Operations Manager agendado com o respetivo nome
PS C:\>Edit-SCOMMaintenanceSchedule -Name "Test" -Enabled 1Edita a Agenda do Modo de Manutenção com o nome .
Parâmetros
-ActiveEndDate
Especifica a data de fim e a hora de fim em que o agendamento irá parar. Se não especificar este parâmetro, a agenda continuará a ser executada até ser eliminada ou desativada.
Por exemplo, se quiser criar uma agenda que deve terminar a 1 de maio de 2016 às 9:00, tem de especificar "01-05-2016 09:00:00" como ActiveEndDate. Pode transmitir uma cadeia especificando o tempo que pretende na hora local. No entanto, se quiser especificar uma hora UTC, terá de 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 tem de ficar ativo. Por exemplo, se quiser uma agenda que deve começar a partir de 1 de maio de 2016 e tem de ser executada às 9:00, tem de especificar "01-05-2016 09:00:00" como ActiveStartTime. Pode transmitir uma cadeia especificando o tempo que pretende na hora local. No entanto, se quiser especificar uma hora UTC, terá de especificar um objeto DateTime com DateTimeKind.
| Type: | DateTime |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Comments
Especifica quaisquer comentários legíveis por humanos 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 ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio completamente qualificados (FQDNs). Para especificar o computador local, escreva o nome do computador, localhost ou um ponto (.). O serviço de Acesso a Dados do System Center tem de estar ativo no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão atual.
| Type: | String[] |
| Position: | Named |
| 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 |
-Credential
Especifica um objeto PSCredential para a ligação do grupo de gestão.
Para obter um objeto PSCredential , utilize o cmdlet Get-Credential.
Para obter mais informações, escreva Get-Help Get-Credential. Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador.
A predefinição é o utilizador 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 durante o qual o agendamento de manutenção durará sempre.
| Type: | Int32 |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Enabled
Indica se o agendamento será ativado ou desativado após a edição. Se definir esta opção como falso, a agenda será desativada. Também pode utilizar a Enable-SCOMMaintenanceSchedule e Disable-SCOMMaintenanceSchedule para o fazer.
| Type: | Boolean |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FreqInterval
Especifica o dia em que a tarefa é executada. Isto é obrigatório se a agenda for outra coisa que não a agenda OnceRecurrence. O valor depende do valor de FreqType , conforme indicado na lista seguinte:
- 1 (uma vez). O intervalo de frequência não é utilizado.
- 4 (diariamente). Todos os dias de intervalo de frequência.
- 8 (semanalmente). O parâmetro FreqInterval é um ou mais dos seguintes (combinados 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 (mensalmente). No dia do intervalo de frequência do mês.
- 32 (mensal relativo). 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 ---- 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 da tarefa. O FreqRecurrenceFactor só é utilizado se o parâmetro FreqType estiver definido como 8, 16 ou 32. O parâmetro FreqRecurrenceFactor é um número inteiro, com um valor predefinido de 0.
| Type: | Int32 |
| Position: | 12 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FreqRelativeInterval
Especifica a agenda quando o parâmetro FreqType está definido como 32 (mensalmente relativo). Este parâmetro pode ser um dos seguintes valores:
- 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 a tarefa deve ser executada. Este parâmetro pode ser um dos seguintes valores:
- 1 (uma vez)
- 4 (diariamente)
- 8 (semanalmente)
- 16 (mensal)
- 32 (Mensalmente, 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 monitorização que este cmdlet coloca no modo de manutenção. Especifica uma matriz de GUIDS de objetos de monitorização que é colocada no modo de manutenção. Para especificar um objeto de monitorização que a agenda coloca no modo de manutenção, tem de transmitir o atributo ID do objeto de monitorização. Se quiser manter alguns dos membros existentes, estes também têm de ser especificados.
Pode especificar um ou mais objetos de monitorização para uma agenda. No entanto, não pode editar uma agenda que não tenha nenhum objeto de monitorização.
| 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 do 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 a agenda é aplicável ao recurso de nível superior ou a todos os recursos contidos. Se definir este parâmetro como falso, apenas o recurso especificado entrará no modo de manutenção quando a agenda for executada. Se estiver definido como verdadeiro, o recurso especificado e todos os recursos que têm uma relação de contenção com este 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 da agenda 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 de Ligação .
| Type: | Connection[] |
| Position: | Named |
| 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 |