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.