Freigeben über


Get-SCOMRule

Ruft Operations Manager-Überwachungsregeln ab.

Syntax

Empty (Standardwert)

Get-SCOMRule
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromMonitoringRuleName

Get-SCOMRule
    -Name <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromMonitoringDisplayRuleName

Get-SCOMRule
    [-DisplayName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromMonitoringRuleId

Get-SCOMRule
    -Id <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromManagementPack

Get-SCOMRule
    [-ManagementPack] <ManagementPack[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromManagementPackClass

Get-SCOMRule
    [-Target] <ManagementPackClass[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Beschreibung

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

Beispiele

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

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

Mit diesem Befehl werden alle Überwachungsregeln abgerufen, deren Name "health" enthält.

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

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

Mit diesem Befehl werden alle Überwachungsregeln mit Leistung in ihrem Anzeigenamen abgerufen.

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

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

Mit diesem Befehl werden alle Management Packs abgerufen, deren Anzeigenamen System Center Core Monitoring enthalten. 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 Platzhalter

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

Mit diesem Befehl werden die Überwachungsregeln für jede Zielklasse abgerufen, deren Anzeigename "Integrität" enthält.

Beispiel 5: Abrufen von Überwachungsregeln durch Angeben eines Management Packs mit dem 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 abgerufen.

Mit dem ersten Befehl wird der Pfad zu einer Management Pack-Datei abgerufen und in der Variablen $MPFile gespeichert.

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

Beispiel 6: Abrufen einer Überwachungsregel durch Angeben einer GUID

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

Mit diesem Befehl wird die Überwachungsregel mit der ID 7413b06b-a95b-4ae3-98f2-dac9ff76dabd abgerufen.

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 Data Access-Dienst muss auf dem Computer gestartet 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 das Benutzerkonto an, unter dem die Verbindung mit der Verwaltungsgruppe ausgeführt wird. Geben Sie für diesen Parameter ein PSCredential-Objekt an, z. B. ein Objekt, das vom Cmdlet Get-Credential zurückgegeben wird. Weitere Informationen zu Objekten mit Anmeldeinformationen erhalten Sie, wenn Sie Get-Help Get-Credential.

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

-DisplayName

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

Wenn dieser Parameter nicht angezeigt wird, ist die Standardbeschreibung die Beschreibung im Parameter Name .

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

FromMonitoringDisplayRuleName
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-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.

Parametereigenschaften

Typ:

Guid[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FromMonitoringRuleId
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ManagementPack

Gibt ein Management Pack-Objekt an, in dem Außerkraftsetzungen gespeichert werden. Verwenden Sie zum Abrufen eines Management Pack-Objekts das Cmdlet Get-SCOMManagementPack . Wenn sich die Regel in einem nicht versiegelten Management Pack befindet, müssen Sie die Außerkraftsetzung im selben Management Pack speichern.

Parametereigenschaften

Typ:

ManagementPack[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FromManagementPack
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt ein Array von Objektnamen an.

Dieser Parameter verwendet jede Zeichenfolge im Array und sucht nach Übereinstimmungen in den Name-Eigenschaften der Objekte, mit denen das Cmdlet arbeitet.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

FromMonitoringRuleName
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-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 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.

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

-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.

Parametereigenschaften

Typ:

ManagementPackClass[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

FromManagementPackClass
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
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.