Freigeben über


Start-SCOMMaintenanceMode

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 Cmdlet Start-SCOMMaintenanceMode versetzt 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 Klasse instance 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 das Cmdlet Get-SCOMMaintenanceMode verwenden, um sowohl aktive als auch inaktive Einträge abzurufen.

Beispiele

Beispiel 1: Versetzen 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 mithilfe des Cmdlets Get-SCOMClassInstance die Klasse instance namens Server01.Contoso.com ab.

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

Der dritte Befehl versetzt die Ressource, die durch das in der $Instance Variable gespeicherte Objekt definiert wird, in den Wartungsmodus. 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.

Type:String
Position:3
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

-EndTime

Gibt an, wann der Wartungsmodus als DateTime-Objekt endet. Eine Ressource kann sich nicht weniger als fünf Minuten im Wartungsmodus befinden. Verwenden Sie das Cmdlet Get-Date, um ein DateTime-Objekt abzurufen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Date.

Type:DateTime
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

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

-PassThru

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

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

-Reason

Gibt einen Grund für den Wartungsmodus an. Zulässige Werte für diesen Parameter:

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Type:MaintenanceModeReason
Position:4
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