Delen via

New-SCOMMaintenanceSchedule

  • Referentie
Module:
OperationsManager

Hiermee maakt u een onderhoudsschema.

Syntaxis

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

De cmdlet New-SCOMMaintenanceSchedule maakt een onderhoudsschema.

Wanneer een resource zich in de onderhoudsmodus bevindt, onderdrukt Operations Manager waarschuwingen, meldingen, regels, monitors, automatische antwoorden, statuswijzigingen en nieuwe waarschuwingen. Een onderhoudsschema kan worden gebruikt om een set resources te plannen om naar de onderhoudsmodus te gaan.

U kunt deze cmdlet gebruiken om schema's te maken die eenmaal, dagelijks, wekelijks of maandelijks worden uitgevoerd op een bepaalde dag of een dag van de week. Met deze cmdlet wordt de GUID van de gemaakte planning geretourneerd.

Deze cmdlet maakt standaard gebruik van de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Voorbeelden

Voorbeeld 1: Windows-computerobject toevoegen aan nieuw onderhoudsschema

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

Voorbeeld van het toevoegen van een Windows-computerobject voor een specifieke server: Agent01.contoso.com in het nieuwe onderhoudsschema, gedurende een periode van 240 minuten, die slechts één keer wordt uitgevoerd.

Voorbeeld 2: Een dagelijks onderhoudsschema maken

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

Voorbeeld van het instellen van een dagelijks onderhoudsschema voor een specifieke server en bijbehorende bewakingsobjecten: Agent01.contoso.local, beginnend om 1:00 uur en gedurende 90 minuten blijvend.

Voorbeeld 3: Een wekelijks onderhoudsschema maken

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

Voorbeeld waarin wordt getoond hoe u elke woensdag een wekelijks onderhoudsschema configureert voor een specifieke server en bijbehorende bewakingsobjecten: Agent01.contoso.local, beginnend om 2:00 uur en gedurende 120 minuten duurt.

Voorbeeld 4: Een maandelijks onderhoudsschema maken

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

Voorbeeld van het vaststellen van een maandelijks onderhoudsschema op de tweede dinsdag van elke maand voor een specifieke server en bijbehorende bewakingsobjecten: Agent01.contoso.local, beginnend om 3:00 uur en gedurende 180 minuten duurt.

Parameters

-ActiveEndDate

Hiermee geeft u de einddatum en de eindtijd op waarop de planning moet stoppen met uitvoeren. Als deze parameter niet is opgegeven, wordt het schema nog steeds uitgevoerd voor ooit (of totdat deze is verwijderd of uitgeschakeld).

Als u bijvoorbeeld een planning wilt maken die eindigt op 1 mei 2016 om 9:00 uur, moet u '01-05-2016 09:00:00' opgeven als ActiveEndDate. U kunt een tekenreeks doorgeven die de gewenste tijd opgeeft in uw lokale tijd. Als u echter een UTC-tijd wilt opgeven, moet u een DateTime--object opgeven met de DateTimeKind ingesteld op UTC.

Type:DateTime
Position:5
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ActiveStartTime

Hiermee geeft u de begindatum en de tijd waarop de planning actief moet worden. Als u bijvoorbeeld een planning wilt maken die moet beginnen vanaf 1 mei 2016 en moet worden uitgevoerd om 9:00 uur, moet u '01-05-2016 09:00:00' opgeven als ActiveStartTime. U kunt een tekenreeks doorgeven die de gewenste tijd opgeeft in uw lokale tijd. Als u echter een UTC-tijd wilt opgeven, moet u een DateTime--object opgeven met de DateTimeKind ingesteld op UTC.

Type:DateTime
Position:4
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Comments

Hiermee geeft u eventuele leesbare opmerkingen voor een onderhoudsschema op.

Type:String
Position:8
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet actief zijn op de computer. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een PSCredential-object voor de verbinding met de beheergroep. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie. Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Duration

Hiermee geeft u de duur van het onderhoudsschema op. De duur van een onderhoudsschema is de tijd waarvoor het onderhoudsschema duurt.

Type:Int32
Aliassen:DurationInMinutes
Position:6
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Enabled

Geeft aan of het schema wordt ingeschakeld of uitgeschakeld bij het maken. Als u dit instelt op false, wordt de planning gemaakt, maar wordt deze uitgeschakeld.

Type:SwitchParameter
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FreqInterval

Hiermee geeft u op wanneer de taak moet worden uitgevoerd. Deze parameter kan een van de volgende waarden zijn:

  • 1 (eenmaal). Frequentie-interval wordt niet gebruikt.
  • 4 (dagelijks). Elke frequentie-intervaldagen.
  • 8 (wekelijks). De parameter FreqInterval is een of meer van de volgende parameters (gecombineerd met een logische OR-operator):
    • 1 - zondag
    • 2 - maandag
    • 4 - dinsdag
    • 8 - woensdag
    • 16 - donderdag
    • 32 - vrijdag
    • 64 - zaterdag
  • 16 (maandelijks). Op de intervaldag van de maand.
    • 1 - zondag
    • 2 - maandag
    • 3 - dinsdag
    • 4 - woensdag
    • 5 - donderdag
    • 6 - vrijdag
    • 7 - zaterdag
  • 32 (maandelijks relatief). De parameter FreqInterval is een van de volgende waarden:
    • 8 - Dag
    • 9 - Weekdag
    • 10 - Weekenddag
Type:Int32
Position:10
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FreqRecurrenceFactor

Aantal weken of maanden tussen de geplande uitvoering van de taak. FreqRecurrenceFactor wordt alleen gebruikt als de parameter FreqType is ingesteld op 8, 16 of 32. De parameter FreqRecurrenceFactor is een geheel getal, met een standaardwaarde van 0.

Type:Int32
Position:11
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FreqRelativeInterval

Dag waarop de taak wordt uitgevoerd. Dit is verplicht als de planning iets anders is dan OnceRecurrence planning. De waarde is afhankelijk van de waarde van FreqType-.

Deze parameter kan een van de volgende waarden zijn:

  • 1 (eerste)
  • 2 (tweede)
  • 4 (Derde)
  • 8 (vierde)
  • 16 (laatste)
Type:Int32
Position:12
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FreqType

Hiermee geeft u op wanneer de taak moet worden uitgevoerd. De acceptabele waarden voor deze parameter zijn:

  • 1 (eenmaal)
  • 4 (dagelijks)
  • 8 (wekelijks)
  • 16 (maandelijks)
  • 32 (Maandelijks ten opzichte van parameter FreqInterval)
Type:Int32
Position:9
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MonitoringObjects

Hiermee geeft u een matrix van bewakingsobjecten GUIDS die wordt geplaatst in de onderhoudsmodus. Als u een bewakingsobject wilt opgeven dat door de gemaakte planning in de onderhoudsmodus wordt geplaatst, moet u het id-kenmerk van het bewakingsobject doorgeven.

U kunt een of meer bewakingsobjecten opgeven voor een planning. U kunt echter geen planning maken zonder bewakingsobject.

Type:Guid[]
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de planning die door deze cmdlet wordt gemaakt.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ReasonCode

Hiermee geeft u de redencode voor een onderhoudsschema op dat de reden voor het onderhoudsvenster aangeeft.

De acceptabele waarden voor deze parameter zijn:

  • Geplande overig
  • Ongepland Overig
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • UnplannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Type:MaintenanceModeReason
Geaccepteerde waarden:PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:7
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Recursive

Geeft aan of de planning van toepassing is op de resource op het hoogste niveau of op alle ingesloten resources. Als de recursieve parameter is ingesteld op false, gaat alleen de opgegeven resource naar de onderhoudsmodus wanneer de planning wordt uitgevoerd. Als dit is ingesteld op true, gaan de opgegeven resource en alle resources met een insluitingsrelatie met deze resource ook naar de onderhoudsmodus.

Type:SwitchParameter
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False