Freigeben über

Set-SCOMMaintenanceMode

  • Referenz
Modul:
OperationsManager

Aktualisiert aktive Wartungsmoduseinträge.

Syntax

Set-SCOMMaintenanceMode
   [-MaintenanceModeEntry] <MaintenanceWindow[]>
   [-PassThru]
   [-EndTime] <DateTime>
   [[-Comment] <String>]
   [[-Reason] <MaintenanceModeReason>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Die Set-SCOMMaintenanceMode Cmdlet aktualisiert aktive Wartungsmoduseinträge. Sie können dieses Cmdlet verwenden, um nur aktive Einträge zu aktualisieren.

Wenn sich eine Ressource im Wartungsmodus befindet, unterdrückt System Center – Operations Manager Warnungen, Benachrichtigungen, Regeln, Monitore, automatische Antworten, Zustandsänderungen und neue Warnungen.

Sie können den Kommentar oder grund für den Wartungsmodus ändern. Verwenden Sie das Cmdlet Get-SCOMMaintenanceMode, um einen Wartungsmoduseintrag zum Aktualisieren abzurufen. Geben Sie ein Ende für das Wartungsfenster an.

Beispiele

Beispiel 1: Aktualisieren von Einträgen im aktiven Wartungsmodus für Ressourcen in einer Domäne

PS C:\>$NewEndTime = (Get-Date).addDays(1)
PS C:\> Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode | Set-SCOMMaintenanceMode -EndTime $NewEndTime -Comment "Updating end time."

In diesem Beispiel werden alle Einträge im aktiven Wartungsmodus für eine angegebene Domäne aktualisiert. Der erste Befehl erstellt ein DateTime--Objekt für einen Tag in der Zukunft und speichert es dann in der $NewEndTime Variablen.

Der zweite Befehl ruft alle Klasseninstanzen in der domäne Contoso.com ab und verwendet den Pipelineoperator (|), um die Klasseninstanzobjekte an die Get-SCOMMaintenanceMode Cmdlet zu übergeben, das Eintragsobjekte für den Wartungsmodus abruft. Der Befehl verwendet den Pipelineoperator, um diese Objekte an das cmdlet Set-SCOMMaintenanceMode zu übergeben. Dieses Cmdlet aktualisiert die Endzeit für jedes Objekt auf das in der $NewEndTime Variable gespeicherte DateTime--Objekt. Der Befehl enthält auch einen Kommentar für jeden eintrag für den aktualisierten Wartungsmodus.

Beispiel 2: Aktualisieren des Wartungsmoduseintrags für eine angegebene Ressource

PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $MMEntry = Get-SCOMMaintenanceMode -Instance $Instance
PS C:\> $NewEndTime = (Get-Date).addMinutes(30)
PS C:\> Set-SCOMMaintenanceMode -MaintenanceModeEntry $MMEntry -EndTime $NewEndTime -Comment "Adding 30 minutes to the end time."

In diesem Beispiel wird der Wartungsmodus für einen angegebenen Server erweitert. Der erste Befehl ruft die Klasseninstanz mit dem Namen Server01.Contoso.com ab und speichert sie dann in der variablen $Instance.

Der zweite Befehl ruft den Wartungsmoduseintrag für die Klasseninstanz ab, die in der variablen $Instance gespeichert ist, und speichert den Eintrag in der variablen $MMEntry.

Der dritte Befehl erstellt ein DateTime- -Objekt für 30 Minuten in der Zukunft und speichert es dann in der $NewEndTime Variablen.

Der vierte Befehl aktualisiert die Wartungsmodussitzung für den Wartungsmoduseintrag, der in der $MMEntry Variablen gespeichert ist, auf das DateTime--Objekt, das in der variablen $NewEndTime gespeichert ist, und fügt einen Kommentar hinzu.

Parameter

-Comment

Gibt einen Kommentar für den Wartungsmoduseintrag an.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EndTime

Gibt an, wann der Wartungsmodus als DateTime- -Objekt endet. Eine Ressource kann nicht länger als fünf Minuten im Wartungsmodus sein. Um ein DateTime--Objekt abzurufen, verwenden Sie das Cmdlet Get-Date. Geben Sie Get-Help Get-Dateein, um weitere Informationen zu erfahren.

Typ:DateTime
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaintenanceModeEntry

Gibt ein Array von MaintenanceWindow- -Objekten an. Um ein MaintenanceWindow-Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMMaintenanceMode.

Typ:MaintenanceWindow[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Reason

Gibt einen Grund für den Wartungsmodus an. Die zulässigen Werte für diesen Parameter sind:

  • GeplantOther
  • UngeplantErOther
  • GeplantHardwareMaintenance
  • UnplannedHardwareMaintenance
  • GeplantHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Typ:MaintenanceModeReason
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False