Set-CMStatusMessageQuery
Ändert Einstellungen oder den Sicherheitsbereich oder löscht Nachrichten für eine Configuration Manager-Statusmeldungsabfrage.
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>] Beschreibung
Das Cmdlet Set-CMStatusMessageQuery ändert die Einstellungen für eine Configuration Manager-Statusmeldungsabfrage. Statusmeldungsabfragen geben Statusmeldungen aus einer Configuration Manager-Standortdatenbank zurück. Sie können einen Kommentar, einen WMI-Ausdruck (Windows Management Infrastructure) oder den Namen einer Abfrage ändern.
Sie können dieses Cmdlet mit dem Parameter DeleteMessage verwenden, um nachrichten zu löschen, die diese Abfrage findet.
Dieses Cmdlet kann auch einen Sicherheitsbereich für eine Nachrichtenabfrage hinzufügen oder entfernen. Jede Statusmeldungsabfrage muss zu mindestens einem Sicherheitsbereich gehören.
Sie können einen Namen oder eine ID für eine Abfrage angeben oder das Cmdlet Get-CMStatusMessageQuery verwenden, um eine Abfrage abzurufen.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Hinzufügen eines Sicherheitsbereichs
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Status Messages" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"Dieser Befehl fügt der Abfrage mit dem Namen Alle Statusmeldungen den Sicherheitsbereich Scope22 hinzu.
Beispiel 2: Löschen von Nachrichten
PS XYZ:\> Set-CMStatusMessageQuery -DeleteMessage -Name "All Active Directory Security Groups"Dieser Befehl entfernt Meldungen, die von der Abfrage mit dem Namen Alle Active Directory-Sicherheitsgruppen gefunden wurden, aus der Configuration Manager-Datenbank.
Beispiel 3: Umbenennen einer Abfrage
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Active Directory Security Groups" -NewName "Western Security Groups"Dieser Befehl benennt die Abfrage in Alle Active Directory-Sicherheitsgruppen um. Der neue Name der Abfrage lautet Westliche Sicherheitsgruppen.
Parameter
-Comment
| Typ: | String |
| Aliase: | Comments |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeleteMessage
Gibt an, dass von dieser Abfrage gefundene Nachrichten aus der Configuration Manager-Datenbank gelöscht werden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Expression
Gibt einen Ausdruck in WMI Query Language (WQL) an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Id
Gibt eine ID für eine Statusmeldungsabfrage an.
| Typ: | String |
| Aliase: | QueryId |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Gibt ein Statusmeldungsabfrageobjekt an. Verwenden Sie zum Abrufen eines Statusmeldungsabfrageobjekts das Cmdlet Get-CMStatusMessageQuery .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt einen Namen für eine Statusmeldungsabfrage an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-NewName
Gibt einen neuen Namen für eine Abfrage an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PassThru
Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object