Set-SCOMMaintenanceMode
Updates einträge im aktiven Wartungsmodus.
Syntax
Set-SCOMMaintenanceMode
[-MaintenanceModeEntry] <MaintenanceWindow[]>
[-PassThru]
[-EndTime] <DateTime>
[[-Comment] <String>]
[[-Reason] <MaintenanceModeReason>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-SCOMMaintenanceMode aktualisiert einträge im aktiven Wartungsmodus. 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 den Grund für den Wartungsmodus ändern. Verwenden Sie das Cmdlet Get-SCOMMaintenanceMode , um einen zu aktualisierenden Wartungsmoduseintrag 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 aktiven Wartungsmoduseinträge 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 variablen $NewEndTime.
Der zweite Befehl ruft alle Klasseninstanzen in der domäne Contoso.com ab und verwendet den Pipelineoperator (|), um die Klasse instance -Objekte an das Cmdlet Get-SCOMMaintenanceMode zu übergeben, das Wartungsmoduseingabeobjekte 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 DateTime-Objekt , das in der variablen $NewEndTime gespeichert ist. Der Befehl enthält auch einen Kommentar für jeden aktualisierten Wartungsmoduseintrag.
Beispiel 2: Eintrag zum Aktualisieren des Wartungsmodus 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 Klasse instance namens Server01.Contoso.com ab und speichert sie dann in der variablen $Instance.
Der zweite Befehl ruft den Wartungsmoduseintrag für die Klasse instance 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 variablen $NewEndTime.
Der vierte Befehl aktualisiert die Wartungsmodussitzung für den in der $MMEntry Variablen gespeicherten Wartungsmoduseintrag auf das dateTime-Objekt , das in der $NewEndTime Variablen gespeichert ist, und fügt einen Kommentar hinzu.
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 |
-MaintenanceModeEntry
Gibt ein Array von MaintenanceWindow-Objekten an. Verwenden Sie zum Abrufen eines MaintenanceWindow-Objekts das Cmdlet Get-SCOMMaintenanceMode .
Type: | MaintenanceWindow[] |
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 |