Auf Englisch lesen

Freigeben über

New-SCOMMaintenanceSchedule

  • Referenz
Modul:
OperationsManager

Erstellt einen Wartungszeitplan.

Syntax

PowerShell 
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 eines Windows-Computerobjekts zum neuen Wartungszeitplan

PowerShell 
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(1)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

Beispiel zum 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 nur 1 Mal ausgeführt.

Parameter

-ActiveEndDate

Gibt das Enddatum und die Endzeit an, zu der der Zeitplan nicht mehr ausgeführt werden soll. Wenn dieser Parameter nicht angegeben wird, 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: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: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. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst 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 der Zeitpunkt, für den der Wartungszeitplan dauert.

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 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). 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 der Zeitplan etwas anderes als der OnceRecurrence-Zeitplan ist. Der Wert hängt vom Wert von FreqType ab.

Dieser Parameter kann einer der folgenden Werte sein:

  • 1 (First)
  • 2 (Second)
  • 4 (Dritte)
  • 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 Überwachungsobjekten 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 mindestens ein Überwachungsobjekt 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