Partager via

Get-SCOMRule

  • Référence
Module:
OperationsManager

Obtient les règles de surveillance Operations Manager.

Syntaxe

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

Description

La cmdlet Get-SCOMRule obtient des règles de surveillance pour System Center - Operations Manager.

Exemples

Exemple 1 : Obtenir des règles de surveillance en spécifiant des noms avec des caractères génériques

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

Cette commande obtient toutes les règles de surveillance qui ont l’intégrité dans leur nom.

Exemple 2 : Obtenir des règles de surveillance en spécifiant des noms d’affichage avec un caractère générique

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

Cette commande obtient toutes les règles de surveillance avec des performances dans leur nom d’affichage.

Exemple 3 : Obtenir une règle d’analyse en spécifiant un pack d’administration

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

Cette commande obtient tous les packs d’administration avec System Center Core Monitoring dans leurs noms d’affichage. Il utilise ensuite l’opérateur de pipeline pour envoyer les objets du pack d’administration à l’applet de commande Get-SCOMRule Get-SCOMRule, qui obtient les règles de surveillance pour chaque objet de pack d’administration.

Exemple 4 : Obtenir des règles de surveillance en spécifiant des classes cibles avec un caractère générique

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

Cette commande obtient les règles de surveillance pour chaque classe cible qui a l’intégrité dans son nom complet.

Exemple 5 : Obtenir des règles de surveillance en spécifiant un pack d’administration avec le chemin d’accès :

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

Cet exemple obtient des règles de surveillance pour un pack d’administration dans un chemin d’accès spécifié.

La première commande obtient le chemin d’accès à un fichier de pack d’administration et la stocke dans la variable $MPFile.

La deuxième commande utilise le paramètre ManagementPack pour obtenir les règles de surveillance à partir du pack d’administration stocké dans la variable $MPFile.

Exemple 6 : Obtenir une règle de surveillance en spécifiant un GUID

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

Cette commande obtient la règle de surveillance qui a un ID de 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.

Paramètres

-ComputerName

Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).

Le service System Center Data Access doit être démarré sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion de groupe d’administration actuelle.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie le compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécute. Spécifiez un objet PSCredential, tel que celui retourné par l’applet de commande Get-Credential Get-Credential, pour ce paramètre. Pour plus d’informations sur les objets d’informations d’identification, tapez Get-Help Get-Credential.

Si vous spécifiez un ordinateur dans le paramètre ComputerName, utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifie un tableau de noms d’affichage pour les objets. Cette applet de commande prend les chaînes de ce tableau et recherche des correspondances entre les propriétés DisplayName des objets avec utilisant l’applet de commande. valeurs displayName dépendent des packs d’administration localisés et importés qui font partie du groupe d’administration et des paramètres régionaux de l’utilisateur qui exécute Windows PowerShell

Si ce paramètre n’apparaît pas, la description par défaut est celle du paramètre Name.

Type:String[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Id

Spécifie un tableau d’ID pour les règles de surveillance. L’applet de commande obtient des règles de surveillance qui correspondent aux GUID.

Un objet SCOMGroup stocke le GUID dans sa propriété Id. Pour obtenir le GUID d’une classe, tapez Get-SCOMGroup | Format-Table DisplayName, ID.

Type:Guid[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ManagementPack

Spécifie un objet de pack d’administration qui stocke les remplacements. Pour obtenir un objet de pack d’administration, utilisez l’applet de commande Get-SCOMManagementPack . Si la règle se trouve dans un pack d’administration non scellé, vous devez enregistrer le remplacement dans le même pack d’administration.

Type:ManagementPack[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie un tableau de noms d’objets.

Ce paramètre prend chaque chaîne dans le tableau et recherche des correspondances entre les propriétés Name des objets avec utilisant l’applet de commande.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-SCSession

Spécifie un tableau d’objets Connection. Pour obtenir objets Connection, utilisez l’applet de commande Get-SCOMManagementGroupConnection .

Si ce paramètre n’est pas spécifié, l’applet de commande utilise la connexion persistante active à un groupe d’administration. Utilisez le paramètre SCSession pour spécifier une connexion persistante différente. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential. Pour plus d’informations, tapez Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Target

Spécifie un tableau d’objets ManagementPackClass. Pour obtenir un objet ManagementPackClass, utilisez l’applet de commande Get-SCClass Get-SCClass. L’applet de commande obtient des règles de surveillance pour ces classes.

Type:ManagementPackClass[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False