Set-CMStatusMessageQuery
Configuration Manager ステータス メッセージ クエリの設定またはセキュリティ スコープを変更するか、メッセージを削除します。
構文
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>] 説明
Set-CMStatusMessageQuery コマンドレットは、Configuration Manager ステータス メッセージ クエリの設定を変更します。 状態メッセージ クエリは、Configuration Manager サイト データベースからステータス メッセージを返します。 コメント、Windows 管理インフラストラクチャ (WMI) 式、またはクエリの名前を変更できます。
このコマンドレットを DeleteMessage パラメーターと共に使用すると、このクエリで検出されたメッセージを削除できます。
このコマンドレットは、メッセージ クエリのセキュリティ スコープを追加または削除することもできます。 すべてのステータス メッセージ クエリは、少なくとも 1 つのセキュリティ スコープに属している必要があります。
クエリの名前または ID を指定するか、 Get-CMStatusMessageQuery コマンドレットを使用してクエリを取得できます。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: セキュリティ スコープを追加する
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Status Messages" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"このコマンドは、Scope22 という名前のセキュリティ スコープを[すべてのステータス メッセージ]という名前のクエリに追加します。
例 2: メッセージを削除する
PS XYZ:\> Set-CMStatusMessageQuery -DeleteMessage -Name "All Active Directory Security Groups"このコマンドは、すべての Active Directory セキュリティ グループという名前のクエリによって検出されたメッセージを Configuration Manager データベースから削除します。
例 3: クエリの名前を変更する
PS XYZ:\> Set-CMStatusMessageQuery -Name "All Active Directory Security Groups" -NewName "Western Security Groups"このコマンドは、クエリのすべての Active Directory セキュリティ グループの名前を変更します。 クエリの新しい名前は Western Security Groups です。
パラメーター
-Comment
| 型: | String |
| Aliases: | Comments |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeleteMessage
このクエリで検出されたメッセージが Configuration Manager データベースから削除されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Expression
WMI クエリ言語 (WQL) で式を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Id
ステータス メッセージ クエリの ID を指定します。
| 型: | String |
| Aliases: | QueryId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
ステータス メッセージ クエリ オブジェクトを指定します。 ステータス メッセージ クエリ オブジェクトを取得するには、 Get-CMStatusMessageQuery コマンドレットを使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
ステータス メッセージ クエリの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NewName
クエリの新しい名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object