Get-SCOMRule

Ruft Operations Manager-Überwachungsregeln ab.

Syntax

Get-SCOMRule
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMRule
   -Name <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMRule
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMRule
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMRule
   [-ManagementPack] <ManagementPack[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMRule
   [-Target] <ManagementPackClass[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCOMRule ruft Überwachungsregeln für System Center 2019 – Operations Manager ab.

Beispiele

Beispiel 1: Abrufen von Überwachungsregeln durch Angeben von Namen mit Wildcard

PS C:\>Get-SCOMRule -Name "*health*"

Dieser Befehl ruft alle Überwachungsregeln ab, die den Status in ihrem Namen aufweisen.

Beispiel 2: Abrufen von Überwachungsregeln durch Angeben von Anzeigenamen mit einem Wildcard

PS C:\>Get-SCOMRule -DisplayName "*performance*"

Dieser Befehl ruft alle Überwachungsregeln mit Leistung im Anzeigenamen ab.

Beispiel 3: Abrufen einer Überwachungsregel durch Angeben eines Management Packs

PS C:\>Get-SCOMManagementPack -DisplayName "System Center Core Monitoring" | Get-SCOMRule

Dieser Befehl ruft alle Verwaltungspakete mit System Center Core Monitoring in ihren Anzeigenamen ab. Anschließend wird der Pipelineoperator verwendet, um die Management Pack-Objekte an das Cmdlet Get-SCOMRule zu senden, das die Überwachungsregeln für jedes Management Pack-Objekt abruft.

Beispiel 4: Abrufen von Überwachungsregeln durch Angeben von Zielklassen mit einem Wildcard

PS C:\>Get-SCOMRule -Target (Get-SCOMClass -DisplayName "*health*")

Dieser Befehl ruft die Überwachungsregeln für jede Zielklasse ab, die den Anzeigenamen enthält.

Beispiel 5: Abrufen von Überwachungsregeln durch Angeben eines Management Packs mit Pfad:

PS C:\>$MPFile = "D:\Program Files\System Center Operations Manager 2007\Microsoft.SystemCenter.2007.mp"
PS C:\> Get-SCOMRule -ManagementPack $MPFile

In diesem Beispiel werden Überwachungsregeln für ein Management Pack in einem angegebenen Pfad angezeigt.

Der erste Befehl ruft den Pfad zu einer Management Pack-Datei ab und speichert ihn in der variablen $MPFile.

Der zweite Befehl verwendet den ManagementPack-Parameter , um die Überwachungsregeln aus dem Management Pack abzurufen, das in der $MPFile Variablen gespeichert ist.

Beispiel 6: Abrufen einer Überwachungsregel durch Angeben einer GUID

PS C:\>Get-SCOMRule -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Dieser Befehl ruft die Überwachungsregel ab, die eine ID von 7413b06b-a95b-4ae3-98f2-dac9ff76dabd hat.

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 Data Access-Dienst muss auf dem Computer gestartet 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 das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie ein PSCredential-Objekt an, z. B. eins, das das Cmdlet Get-Credential zurückgibt, für diesen Parameter. Geben Sie weitere Informationen zu Anmeldeinformationenobjekten ein 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

-DisplayName

Gibt ein Array von Anzeigenamen für Objekte an. Dieses Cmdlet verwendet die Zeichenfolgen in diesem Array und sucht nach Übereinstimmungen zwischen den DisplayName-Eigenschaften der Objekte, mit denen das Cmdlet arbeitet. DisplayName-Werte hängen von den lokalisierten, importierten Verwaltungspaketen ab, die Teil der Verwaltungsgruppe und das Gebietsschema des Benutzers sind, der Windows PowerShell

Wenn dieser Parameter nicht angezeigt wird, ist die Standardbeschreibung die in dem Parameter Name enthaltene.

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

-Id

Gibt ein Array von IDs für Überwachungsregeln an. Das Cmdlet ruft Überwachungsregeln ab, die mit den GUIDs übereinstimmen.

Ein SCOMGroup-Objekt speichert die GUID in seiner ID-Eigenschaft. Um die GUID einer Klasse abzurufen, geben Sie Get-SCOMGroup | Format-Table DisplayName, ID.

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

-ManagementPack

Gibt ein Management Pack-Objekt an, das Außerkraftsetzungen speichert. Verwenden Sie das Cmdlet Get-SCOMManagementPack , um ein Management Pack-Objekt abzurufen. Wenn sich die Regel in einem nicht zusammengefassten Management Pack befindet, müssen Sie die Außerkraftsetzung in dasselbe Management Pack speichern.

Type:ManagementPack[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt ein Array von Objektnamen an.

Dieser Parameter verwendet jede Zeichenfolge im Array und sucht nach Übereinstimmungen zwischen den Namenseigenschaften der Objekte, mit denen das Cmdlet arbeitet.

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

-SCSession

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

Wenn dieser Parameter nicht angegeben ist, verwendet das Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe mithilfe der Parameter "ComputerName " und "Anmeldeinformationen " erstellen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

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

-Target

Gibt ein Array von ManagementPackClass-Objekten an. Verwenden Sie zum Abrufen eines ManagementPackClass-Objekts das Cmdlet Get-SCClass . Das Cmdlet ruft Überwachungsregeln für diese Klassen ab.

Type:ManagementPackClass[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False