Freigeben über

Start-SCOMMaintenanceMode

Modul:
OperationsManager Module

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

Syntax

Default (Standardwert) 

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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

MonitoringObject[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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

Parametereigenschaften

Typ:MaintenanceModeReason
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:4
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.