Partager via

Set-CMStatusMessageQuery

  • Référence
Module:
ConfigurationManager

Modifie les paramètres ou l’étendue de sécurité ou supprime les messages d’une requête de message d’état Configuration Manager.

Syntax

Set-CMStatusMessageQuery
   [-Comment <String>]
   [-Expression <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-Comment <String>]
   [-Expression <String>]
   -Id <String>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-Comment <String>]
   [-Expression <String>]
   -Name <String>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-DeleteMessage]
   -InputObject <IResultObject>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-DeleteMessage]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStatusMessageQuery
   [-DeleteMessage]
   -Id <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Set-CMStatusMessageQuery modifie les paramètres d’une requête de message d’état Configuration Manager. Les requêtes de message d’état retournent des messages d’état à partir d’une base de données de site Configuration Manager. Vous pouvez modifier un commentaire, une expression WMI (Windows Management Infrastructure) ou le nom d’une requête.

Vous pouvez utiliser cette cmdlet avec le paramètre DeleteMessage pour supprimer les messages que cette requête trouve.

Cette cmdlet peut également ajouter ou supprimer une étendue de sécurité pour une requête de message. Chaque requête de message d’état doit appartenir à au moins une étendue de sécurité.

Vous pouvez spécifier un nom ou un ID pour une requête ou utiliser la cmdlet Get-CMStatusMessageQuery pour obtenir une requête.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1 : Ajouter une étendue de sécurité

PS XYZ:\> Set-CMStatusMessageQuery -Name "All Status Messages" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"

Cette commande ajoute l’étendue de sécurité nommée Scope22 à la requête nommée Tous les messages d’état.

Exemple 2 : Supprimer des messages

PS XYZ:\> Set-CMStatusMessageQuery -DeleteMessage -Name "All Active Directory Security Groups"

Cette commande supprime les messages trouvés par la requête nommée Tous les groupes de sécurité Active Directory de la base de données Configuration Manager.

Exemple 3 : renommer une requête

PS XYZ:\> Set-CMStatusMessageQuery -Name "All Active Directory Security Groups" -NewName "Western Security Groups"

Cette commande renomme la requête Tous les groupes de sécurité Active Directory. Le nouveau nom de la requête est Groupes de sécurité occidental.

Paramètres

- Confirmer

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Comment

Type:String
Aliases:Comments
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeleteMessage

Indique que les messages trouvés par cette requête sont supprimés de la base de données Configuration Manager.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Expression

Spécifie une expression en WMI Query Language (WQL).

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Spécifie un ID pour une requête de message d’état.

Type:String
Aliases:QueryId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifie un objet de requête de message d’état. Pour obtenir un objet de requête de message d’état, utilisez la cmdlet Get-CMStatusMessageQuery.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie un nom pour une requête de message d’état.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Spécifie un nouveau nom pour une requête.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette cmdlet peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object