Get-SCOMMaintenanceMode
Ruft Einträge für den Wartungsmodus ab.
Syntax
Default (Standardwert)
Get-SCOMMaintenanceMode
[[-Instance] <MonitoringObject[]>]
[-History]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-SCOMMaintenanceMode ruft Einträge für den Wartungsmodus ab. Sie können dieses Cmdlet verwenden, um Objekte für das Cmdlet Set-SCOMMaintenanceMode bereitzustellen, oder um Details zu Einträgen im Wartungsmodus anzuzeigen.
Wenn sich eine Ressource im Wartungsmodus befindet, unterdrückt System Center – Operations Manager Warnungen, Benachrichtigungen, Regeln, Monitore, automatische Antworten, Zustandsänderungen und neue Warnungen.
Wenn Sie dieses Cmdlet allein verwenden, werden Informationen für die Ortszeit angezeigt.
Wenn Sie die Ergebnisse über die Pipeline an das Cmdlet Format-Table übergeben, stellt das Cmdlet Informationen in koordinierter Weltzeit (UTC) bereit.
Weitere Informationen zu Format-Table erhalten Sie, Get-Help Format-Tablewenn Sie .
Standardmäßig verwendet dieses Cmdlet die aktive persistente Verbindung mit einer Verwaltungsgruppe.
Verwenden Sie den Parameter SCSession , um eine andere persistente Verbindung anzugeben.
Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Credential verwenden.
Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.
Beispiele
Beispiel 1: Abrufen aller Einträge im aktiven Wartungsmodus
PS C:\>Get-SCOMMaintenanceMode
Mit diesem Befehl werden alle Einträge im aktiven Wartungsmodus abgerufen. Um inaktive Einträge einzuschließen, geben Sie den Parameter History an.
Beispiel 2: Abrufen aller aktiven Wartungsmodus-Einträge für eine angegebene Domäne
PS C:\>Get-SCOMMaintenanceMode -Instance (Get-SCOMClassInstance -Name "*.Contoso.com") -ErrorAction SilentlyContinue
Mit diesem Befehl werden alle aktiven Wartungsmoduseinträge für Klasseninstanzen in der Domäne Contoso.com abgerufen. Der Befehl verwendet das Cmdlet Get-SCOMClassInstance , um die Instanzen abzurufen, die Contoso.com enthalten.
Wenn der Befehl auf eine Klasseninstanz trifft, für die keine Einträge im aktiven Wartungsmodus vorhanden sind, kann der Befehl mit dem Parameter ErrorAction fortgesetzt werden, ohne dass ein Fehler angezeigt wird.
Beispiel 3: Abrufen aller Wartungsmodus-Einträge für eine angegebene Domäne
PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode -History
Mit diesem Befehl werden alle Klasseninstanzen in der Domäne Contoso.com abgerufen und dann der Pipelineoperator (|) verwendet, um die Klasseninstanzobjekte an das Cmdlet Get-SCOMMaintenanceMode zu übergeben. In diesem Beispiel wird der Parameter History verwendet. Daher ruft der Befehl alle Einträge im Wartungsmodus ab, einschließlich inaktiver Einträge.
Parameter
-ComputerName
Gibt ein Array von Namen von Computern an. Das Cmdlet stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (Fully Qualified Domain Names, FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.
Der System Center-Datenzugriffsdienst muss auf dem Computer ausgeführt werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.
Parametereigenschaften
| Typ: | String[] |
| 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 |
-Credential
Gibt ein PSCredential- -Objekt für die Verwaltungsgruppenverbindung an.
Verwenden Sie das Cmdlet Get-Credential, um ein PSCredential-Objekt abzurufen.
Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.
Wenn Sie im Parameter ComputerName einen Computer angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.
Parametereigenschaften
| Typ: | PSCredential |
| 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 |
-History
Gibt an, dass das Cmdlet alle Einträge im Wartungsmodus abruft, einschließlich inaktiver Einträge. Ohne diesen Parameter ruft das Cmdlet nur Einträge im aktiven Wartungsmodus ab.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | False |
| 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.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SCSession
Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCOMManagementGroupConnection.
Parametereigenschaften
| Typ: | Connection[] |
| 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 |
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.