Freigeben über

Start-SCOMMaintenanceMode

  • Referenz
Modul:
OperationsManager

Versetzt ein Objekt in den Wartungsmodus und erstellt einen aktiven Wartungsmoduseintrag.

Syntax

Start-SCOMMaintenanceMode
     [-Instance] <MonitoringObject[]>
     [-EndTime] <DateTime>
     [[-Comment] <String>]
     [[-Reason] <MaintenanceModeReason>]
     [-PassThru]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Start-SCOMMaintenanceMode Cmdlet platziert ein überwachtes Objekt, z. B. einen Computer oder eine verteilte Anwendung, in den Wartungsmodus und erstellt einen aktiven Wartungsmoduseintrag. Wenn sich eine Ressource im Wartungsmodus befindet, unterdrückt System Center – Operations Manager Warnungen, Benachrichtigungen, Regeln, Monitore, automatische Antworten, Zustandsänderungen und neue Warnungen.

Geben Sie eine Klasseninstanz an, die in den Wartungsmodus versetzt werden soll, und eine Endzeit für das Wartungsfenster. Sie können auch einen Kommentar und einen Grund für den Wartungsmodus einfügen. Sie können das Cmdlet Set-SCOMMaintenanceMode verwenden, um einen aktiven Wartungsmoduseintrag zu aktualisieren und den Get-SCOMMaintenanceMode Cmdlet zum Abrufen von aktiven und inaktiven Einträgen zu verwenden.

Beispiele

Beispiel 1: Einfügen einer Ressource in den Wartungsmodus

PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $Time = ((Get-Date).AddMinutes(10))
PS C:\> Start-SCOMMaintenanceMode -Instance $Instance -EndTime $Time -Comment "Applying software update." -Reason "SecurityIssue"

In diesem Beispiel wird eine Ressource zehn Minuten lang in den Wartungsmodus versetzt. Der erste Befehl ruft die Klasseninstanz namens Server01.Contoso.com mithilfe des cmdlets Get-SCOMClassInstance ab.

Der zweite Befehl erstellt ein DateTime- -Objekt für zehn Minuten in der Zukunft und speichert es dann in der $Time Variablen.

Mit dem dritten Befehl wird die ressource, die durch das objekt definiert wird, das in der $Instance Variablen gespeichert ist, in den Wartungsmodus versetzt. Der Wartungsmodus endet zu dem Zeitpunkt, der in der variablen $Time gespeichert ist. Der Befehl enthält einen Grund für den Wartungsmodus und einen Kommentar.

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 endet, als DateTime- -Objekt. 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

-Instance

Gibt ein Array von Überwachungsobjekten an, die Instanzen darstellen. Verwenden Sie zum Abrufen von Überwachungsobjekten das cmdlet Get-SCOMClassInstance.

Dieser Parameter akzeptiert auch Gruppenobjekte. Verwenden Sie zum Abrufen eines Gruppenobjekts das cmdlet Get-SCOMGroup.

Typ:MonitoringObject[]
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