Freigeben über

Get-SCOMMaintenanceMode

  • Referenz
Modul:
OperationsManager

Ruft Wartungsmoduseinträge ab.

Syntax

Get-SCOMMaintenanceMode
   [[-Instance] <MonitoringObject[]>]
   [-History]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCOMMaintenanceMode ruft Wartungsmoduseinträge ab. Sie können dieses Cmdlet verwenden, um Objekte für das Cmdlet Set-SCOMMaintenanceMode bereitzustellen oder selbst Details zu Wartungsmoduseinträgen 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 selbst verwenden, werden Informationen für die Ortszeit angezeigt. Wenn Sie die Ergebnisse an das Cmdlet Format-Table übergeben, stellt das Cmdlet Informationen in koordinierter Weltzeit (UTC) bereit. Um weitere Informationen zu Format-Table zu erfahren, geben Sie ein Get-Help Format-Table.

Standardmäßig verwendet dieses Cmdlet die aktive persistente Verbindung mit einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , 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 Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

Beispiele

Beispiel 1: Abrufen aller aktiven Wartungsmoduseinträge

PS C:\>Get-SCOMMaintenanceMode

Dieser Befehl ruft alle aktiven Wartungsmoduseinträge ab. Geben Sie den History-Parameter an, um inaktive Einträge einzuschließen.

Beispiel 2: Abrufen aller aktiven Wartungsmoduseinträ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 Klasse instance trifft, die keine aktiven Wartungsmoduseinträge enthält, ermöglicht der ErrorAction-Parameter, dass der Befehl fortgesetzt werden kann, ohne dass ein Fehler angezeigt wird.

Beispiel 3: Abrufen aller Wartungsmoduseinträge für eine angegebene Domäne

PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode -History

Dieser Befehl ruft alle Klasseninstanzen in der domäne Contoso.com ab und verwendet dann den Pipelineoperator (|), um die Klasse instance -Objekte an das Cmdlet Get-SCOMMaintenanceMode zu übergeben. In diesem Beispiel wird der Parameter History verwendet. Daher ruft der Befehl alle Wartungsmoduseinträge 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 (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an. Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-History

Gibt an, dass das Cmdlet alle Wartungsmoduseinträge abruft, einschließlich inaktiver Einträge. Ohne diesen Parameter ruft das Cmdlet nur aktive Wartungsmoduseinträge ab.

Type:SwitchParameter
Position:2
Default value:None
Required:False
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:False
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCOMManagementGroupConnection .

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False