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 |