Remove-CMStatusFilterRule

  • リファレンス
モジュール:
ConfigurationManager

ステータス メッセージの指定したConfiguration Manager フィルター規則を削除します。

構文

Remove-CMStatusFilterRule
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMStatusFilterRule
      [-Force]
      -Name <String>
      [-SiteCode <String>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-CMStatusFilterRule コマンドレットは、ステータス メッセージの指定されたConfiguration Managerフィルター規則を削除します。

状態フィルター規則では、Configuration Managerがステータス メッセージに応答する方法を指定します。 各フィルター 規則には、ステータス メッセージの条件とアクションが含まれています。 すべてのサイトではなく、サイトごとにステータス フィルター規則を構成します。

ルール名とサイト コードを使用して、削除するルールを指定します。 このコマンドレットは、ルールを完全に削除します。 Disable-CMStatusFilterRule コマンドレットを使用して、ルールを中断できます。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: ルールを削除する

PS XYZ:\> Remove-CMStatusFilterRule -Name "Status change to critical" -SiteCode "CM1" -Force

このコマンドは、サイト コード CM1 を持つサイトで指定された名前を持つ状態フィルター規則を削除します。 コマンドには Force パラメーターが含まれているため、コマンドレットは確認を求めないようにします。

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-InputObject

削除する状態フィルター規則オブジェクトを指定します。 状態フィルター規則オブジェクトを取得するには、 Get-CMStatusFilterRule コマンドレットを 使用します。

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

-Name

ルールの名前を指定します。

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

-SiteCode

Configuration Manager サイトのサイト コードを指定します。

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

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject