Share via

New-SCOMMaintenanceSchedule

  • Referenz
Modul:
OperationsManager

Erstellt einen Wartungszeitplan.

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

Beschreibung

Das Cmdlet New-SCOMMaintenanceSchedule erstellt einen Wartungszeitplan.

Wenn sich eine Ressource im Wartungsmodus befindet, unterdrückt Operations Manager Warnungen, Benachrichtigungen, Regeln, Monitore, automatische Antworten, Zustandsänderungen und neue Warnungen. Ein Wartungszeitplan kann verwendet werden, um eine Reihe von Ressourcen für den Wechsel in den Wartungsmodus zu planen.

Sie können dieses Cmdlet verwenden, um Zeitpläne zu erstellen, die einmal, täglich, wöchentlich oder monatlich an einem bestimmten Tag oder einem Bestimmten Wochentag ausgeführt werden. Dieses Cmdlet gibt die GUID des erstellten Zeitplans zurück.

Standardmäßig verwendet dieses Cmdlet die aktive persistente Verbindung mit einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Credential verwenden. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

Beispiele

Beispiel 1: Hinzufügen des Windows-Computerobjekts zum neuen Wartungszeitplan

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

Beispiel für das Hinzufügen eines Windows-Computerobjekts für einen bestimmten Server: Agent01.contoso.com in den neuen Wartungszeitplan für eine Dauer von 240 Minuten und wird nur 1 Mal ausgeführt.

Beispiel 2: Erstellen eines täglichen Wartungszeitplans

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

Beispiel, das zeigt, wie sie einen täglichen Wartungszeitplan für einen bestimmten Server und die zugehörigen Überwachungsobjekte einrichten: Agent01.contoso.local, beginnend um 1:00 Uhr morgens und 90 Minuten lang.

Beispiel 3: Erstellen eines wöchentlichen Wartungszeitplans

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

Beispiel für die Konfiguration eines wöchentlichen Wartungszeitplans jeden Mittwoch für einen bestimmten Server und die zugehörigen Überwachungsobjekte: Agent01.contoso.local, beginnend um 2:00 Uhr morgens und 120 Minuten lang.

Beispiel 4: Erstellen eines monatlichen Wartungszeitplans

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

Beispiel: Einrichten eines monatlichen Wartungszeitplans am zweiten Dienstag jeden Monats für einen bestimmten Server und zugehörige Überwachungsobjekte: Agent01.contoso.local, beginnend um 3:00 Uhr morgens und 180 Minuten lang.

Parameter

-ActiveEndDate

Gibt das Enddatum und die Endzeit an, zu der der Zeitplan nicht mehr ausgeführt werden soll. Wenn dieser Parameter nicht angegeben ist, wird der Zeitplan für immer ausgeführt (oder bis er gelöscht oder deaktiviert wird).

Wenn Sie für instance einen Zeitplan erstellen möchten, der am 1. Mai 2016 um 9:00 Uhr enden soll, müssen Sie "01-05-2016 09:00:00" als ActiveEndDate angeben. Sie können eine Zeichenfolge übergeben, die die gewünschte Zeit in Ihrer Ortszeit angibt. Wenn Sie jedoch eine UTC-Zeit angeben möchten, sollten Sie ein DateTime-Objekt angeben, bei dem dateTimeKind auf UTC festgelegt ist.

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

-ActiveStartTime

Gibt das Startdatum und die Uhrzeit an, zu der der Zeitplan aktiv werden muss. Wenn Sie für instance einen Zeitplan erstellen möchten, der am 1. Mai 2016 beginnen und um 9:00 Uhr ausgeführt werden muss, müssen Sie "01-05-2016 09:00:00" als ActiveStartTime angeben. Sie können eine Zeichenfolge übergeben, die die gewünschte Zeit in Ihrer Ortszeit angibt. Wenn Sie jedoch eine UTC-Zeit angeben möchten, müssen Sie ein DateTime-Objekt angeben, bei dem DateTimeKind auf UTC festgelegt ist.

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

-Comments

Gibt alle lesbaren Kommentare für einen Wartungszeitplan an.

Type:String
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, localhost oder einen Punkt (.) ein.

Der System Center-Datenzugriffsdienst muss auf dem Computer aktiv sein. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an. Zum Abrufen eines PSCredential-Objekts verwenden Sie das Get-Credential-Cmdlet. Um weitere Informationen zu erfahren, geben Sie ein Get-Help Get-Credential. Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Duration

Gibt die Dauer des Wartungszeitplans an. Die Dauer eines Wartungszeitplans ist die Dauer des Wartungszeitplans.

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

-Enabled

Gibt an, ob der Zeitplan bei der Erstellung aktiviert oder deaktiviert wird. Wenn Sie dies auf false festlegen, wird der Zeitplan erstellt, aber er wird deaktiviert.

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

-FreqInterval

Gibt an, wann der Auftrag ausgeführt werden soll. Dieser Parameter kann einer der folgenden Werte sein:

  • 1 (einmal). Das Häufigkeitsintervall wird nicht verwendet.
  • 4 (täglich). Alle Häufigkeitsintervalltage.
  • 8 (wöchentlich). Der FreqInterval-Parameter ist mindestens einer der folgenden Parameter (in Kombination mit einem logischen OR-Operator):
    • 1 - Sonntag
    • 2 – Montag
    • 4 - Dienstag
    • 8 - Mittwoch
    • 16 - Donnerstag
    • 32 - Freitag
    • 64 - Samstag
  • 16 (monatlich). Im Häufigkeitsintervall Tag des Monats.
    • 1 - Sonntag
    • 2 – Montag
    • 3 - Dienstag
    • 4 – Mittwoch
    • 5 - Donnerstag
    • 6 - Freitag
    • 7 - Samstag
  • 32 (monatlich relativ). Der FreqInterval-Parameter ist einer der folgenden Werte:
    • 8 - Tag
    • 9 - Wochentag
    • 10 - Wochenendtag
Type:Int32
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRecurrenceFactor

Die Anzahl der Wochen oder Monate zwischen den geplanten Ausführungen des Auftrags. FreqRecurrenceFactor wird nur verwendet, wenn der FreqType-Parameter auf 8, 16 oder 32 festgelegt ist. Der FreqRecurrenceFactor-Parameter ist eine ganze Zahl mit dem Standardwert 0.

Type:Int32
Position:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqRelativeInterval

Der Tag, an dem der Auftrag ausgeführt wird. Dies ist obligatorisch, wenn es sich bei dem Zeitplan um einen anderen Zeitplan als "OnceRecurrence " handelt. Der Wert hängt vom Wert von FreqType ab.

Dieser Parameter kann einer der folgenden Werte sein:

  • 1 (First)
  • 2 (Zweite)
  • 4 (Drittens)
  • 8 (Vierter)
  • 16 (Zuletzt)
Type:Int32
Position:12
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FreqType

Gibt an, wann der Auftrag ausgeführt werden soll. Zulässige Werte für diesen Parameter:

  • 1 (einmal)
  • 4 (täglich)
  • 8 (wöchentlich)
  • 16 (monatlich)
  • 32 (Monatlich, relativ zum Parameter FreqInterval)
Type:Int32
Position:9
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MonitoringObjects

Gibt ein Array von Überwachungsobjekt-GUIDS an, das in den Wartungsmodus versetzt wird. Um ein Überwachungsobjekt anzugeben, das vom erstellten Zeitplan in den Wartungsmodus versetzt wird, müssen Sie das ID-Attribut des Überwachungsobjekts übergeben.

Sie können ein oder mehrere Überwachungsobjekte für einen Zeitplan angeben. Sie können jedoch keinen Zeitplan ohne Überwachungsobjekt erstellen.

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

-Name

Gibt den Namen des Zeitplans an, den dieses Cmdlet erstellt.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReasonCode

Gibt den Grundcode für einen Wartungszeitplan an, der den Grund für das Wartungsfenster angibt.

Zulässige Werte für diesen Parameter:

  • 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

Gibt an, ob der Zeitplan für die Ressource der obersten Ebene oder für alle enthaltenen Ressourcen gilt. Wenn der rekursive Parameter auf false festgelegt ist, wechselt nur die angegebene Ressource in den Wartungsmodus, wenn der Zeitplan ausgeführt wird. Wenn dies auf true festgelegt ist, wechseln auch die angegebene Ressource und alle Ressourcen, die eine Eindämmungsbeziehung mit dieser Ressource haben, in den Wartungsmodus.

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

-SCSession

Gibt ein Array von Connection-Objekten an.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False