Set-SCOMMaintenanceMode
Aktualisiert aktive Wartungsmoduseinträge.
Syntax
Default (Standardwert)
Set-SCOMMaintenanceMode
[-MaintenanceModeEntry] <MaintenanceWindow[]>
[-PassThru]
[-EndTime] <DateTime>
[[-Comment] <String>]
[[-Reason] <MaintenanceModeReason>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Die Set-SCOMMaintenanceMode Cmdlet aktualisiert aktive Wartungsmoduseinträge. 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 grund für den Wartungsmodus ändern. Verwenden Sie das Cmdlet Get-SCOMMaintenanceMode, um einen Wartungsmoduseintrag zum Aktualisieren 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 Einträge im aktiven Wartungsmodus 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 $NewEndTime Variablen.
Der zweite Befehl ruft alle Klasseninstanzen in der domäne Contoso.com ab und verwendet den Pipelineoperator (|), um die Klasseninstanzobjekte an die Get-SCOMMaintenanceMode Cmdlet zu übergeben, das Eintragsobjekte für den Wartungsmodus 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 in der $NewEndTime Variable gespeicherte DateTime--Objekt. Der Befehl enthält auch einen Kommentar für jeden eintrag für den aktualisierten Wartungsmodus.
Beispiel 2: Aktualisieren des Wartungsmoduseintrags 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 Klasseninstanz mit dem Namen Server01.Contoso.com ab und speichert sie dann in der variablen $Instance.
Der zweite Befehl ruft den Wartungsmoduseintrag für die Klasseninstanz 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 $NewEndTime Variablen.
Der vierte Befehl aktualisiert die Wartungsmodussitzung für den Wartungsmoduseintrag, der in der $MMEntry Variablen gespeichert ist, auf das DateTime--Objekt, das in der variablen $NewEndTime gespeichert ist, und fügt einen Kommentar hinzu.
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 als DateTime- -Objekt endet.
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 |
-MaintenanceModeEntry
Gibt ein Array von MaintenanceWindow- -Objekten an. Um ein MaintenanceWindow-Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMMaintenanceMode.
Parametereigenschaften
| Typ: | MaintenanceWindow[] |
| 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.