Set-CMStatusMessageQuery
變更設定或安全性範圍,或刪除 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
CMStatusMessageQuery 指令程式會變更 Configuration Manager 狀態郵件查詢的設定。 狀態郵件查詢會傳回 Configuration Manager 網站資料庫的狀態郵件。 您可以修改批註、Windows 管理基礎結構 (WMI) 運算式,或查詢的名稱。
您可以將此 Cmdlet 與 DeleteMessage 參數搭配使用,以刪除此查詢找到的郵件。
此 Cmdlet 也可以新增或移除郵件查詢的安全性範圍。 每個狀態訊息查詢都必須至少屬於一個安全性範圍。
您可以指定查詢的名稱或 ID,或使用 CMStatusMessageQuery 指令 程式 來取得查詢。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例1:新增安全性範圍
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Status Messages" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"
這個命令會將名為 Scope22 的安全性範圍新增至名為 All Status Messages 的查詢。
範例2:刪除郵件
PS XYZ:\> Set-CMStatusMessageQuery -DeleteMessage -Name "All Active Directory Security Groups"
這個命令會從 Configuration Manager 資料庫中移除名為所有 Active Directory 安全性群組的查詢所找到的郵件。
範例3:重新命名查詢
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Active Directory Security Groups" -NewName "Western Security Groups"
此命令會將查詢重新命名為所有 Active Directory 安全性群組。 查詢的新名稱是「西方安全性群組。
參數
-Comment
Type: | String |
Aliases: | Comments |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeleteMessage
表示此查詢所找到的郵件會從 Configuration Manager 資料庫中刪除。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定狀態郵件查詢物件。 若要取得狀態郵件查詢物件,請使用 CMStatusMessageQuery Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NewName
會指定查詢的新名稱。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
新增此參數可傳回代表您正在使用之專案的物件。 根據預設,此 Cmdlet 可能不會產生任何輸出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名稱
指定狀態郵件查詢的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-識別碼
指定狀態郵件查詢的識別碼。
Type: | String |
Aliases: | QueryId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-運算式
指定 WMI 查詢語言 (WQL) 中的運算式。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
系統.物件