Partager via

Get-CMComponentStatusMessage

  • Référence
Module:
ConfigurationManager

Obtenez les messages d’état des composants dans Configuration Manager.

Syntaxe

Get-CMComponentStatusMessage
   [-ComponentName <String>]
   [-ComputerName <String>]
   [-Severity <Severity>]
   [-SiteCode <String>]
   -StartTime <DateTime>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

L’applet de commande Get-CMComponentStatusMessage obtient les messages d’état du composant pour une période spécifiée.

Configuration Manager indique si les opérations réussissent ou échouent et incluent d’autres informations dans les messages d’état des composants. Les threads ou processus envoient des messages d’état des composants aux sites Configuration Manager, qui sont identifiés par des codes de site.

Vous pouvez définir les messages à obtenir en fonction de la gravité du message, du composant qui a créé le message, de l’ordinateur qui héberge ce composant ou du serveur Configuration Manager qui reçoit le message. Spécifiez toujours une période d’affichage en tant qu’objet TimeSpan .

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir des messages d’erreur pour un site

Cet exemple obtient tous les messages avec la gravité de l’erreur à partir d’une heure de début spécifique.

Get-CMComponentStatusMessage -StartTime "2/1/2013 12:00 AM" -Severity Error

Exemple 2 : Obtenir des messages d’avertissement pour un site au cours des dernières 24 heures

Cet exemple obtient tous les avertissements pour un site spécifique au cours du dernier jour.

Get-CMComponentStatusMessage -StartTime $(Get-Date).AddHours(-24) -Severity Warning -SiteCode "CM1"

Exemple 3 : Obtenir un résumé des messages pour tous les composants au cours des dernières 24 heures

Cet exemple utilise d’abord l’applet de commande Get-CMSiteComponent pour obtenir la liste de tous les composants du site actuel. Il dirige cette liste via plusieurs applets de commande pour mettre en forme la liste, puis effectue une boucle dans chaque composant. Pour chaque composant, il obtient les messages d’erreur et d’état d’avertissement pour le dernier jour. Il résume ensuite le nombre d’erreurs et d’avertissements pour chaque composant au cours du dernier jour.

Remarque

L’exécution de cette commande peut prendre plusieurs minutes.

PS OPC:\> Get-CMSiteComponent | Select-Object -ExpandProperty ComponentName -Unique | Sort-Object ComponentName | ForEach-Object {
    $errs  = $(Get-CMComponentStatusMessage -ComponentName $_ -Severity Error -StartTime $(Get-Date).AddHours(-24)).Count
    $warns = $(Get-CMComponentStatusMessage -ComponentName $_ -Severity Warning -StartTime $(Get-Date).AddHours(-24)).Count
    [pscustomobject]@{
        Component  = $_
        Errors     = $errs
        Warnings   = $warns
    }
}

Component                             Errors Warnings
---------                             ------ --------
SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT    742        0
SMS_WSUS_SYNC_MANAGER                     90        0
SMS_WSUS_CONFIGURATION_MANAGER             0        0
SMS_WSUS_CONTROL_MANAGER                  62        0
SMS_AD_SYSTEM_DISCOVERY_AGENT              0        0
SMS_CLIENT_HEALTH                          0        0
SMS_CLOUD_PROXYCONNECTOR                   0        0
SMS_AD_USER_DISCOVERY_AGENT                0      612
...

Paramètres

-ComponentName

Spécifie le nom d’un thread ou d’un processus. Un thread ou un processus envoie un message d’état de composant.

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

-ComputerName

Définissez l’étendue des résultats des messages d’état et spécifiez le nom d’un ordinateur qui héberge un composant.

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-Severity

Spécifie la gravité des messages d’état de composant à obtenir.

Remarque

Ce paramètre ne fonctionne actuellement pas avec la All valeur, mais ne retourne pas non plus de valeurs en cas d’omission.

Type:Severity
Valeurs acceptées:All, Error, Warning, Information
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SiteCode

Spécifie un code de site à partir duquel obtenir les messages d’état du composant.

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

-StartTime

Spécifiez une heure pour le début de la période d’affichage pour les messages d’état du composant.

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

Entrées

None

Sorties

IResultObject[]

IResultObject