Remove-CMDeviceCollectionQueryMembershipRule

リファレンス

モジュール:: ConfigurationManager

デバイスコレクションからクエリメンバーシップルールを削除します。

構文

Remove-CMDeviceCollectionQueryMembershipRule
      -InputObject <IResultObject>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionQueryMembershipRule
      -CollectionName <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMDeviceCollectionQueryMembershipRule
      -CollectionId <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドレットを使用して、デバイスコレクションからクエリメンバーシップルールを削除します。クエリ ルール を使用すると、スケジュールに従って実行されるクエリに基づいてコレクションのメンバーシップを動的に更新できます。既定のコレクションからクエリルールを削除できない。ターゲットとするコレクションには、サイトコードで始まる ID を持つ必要があります SMS 。詳細については、「Configuration Manager でコレクションを作成する方法」を参照してください。

コレクションからクエリメンバーシップルールを削除すると、複数のリソースがコレクションのメンバーでなくなる可能性があります。このアクションを実行すると、ソフトウェアまたは構成の展開がデバイスに適用されない可能性があります。

注意

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

例

例 1: デバイスコレクションのクエリメンバーシップルールを削除する

このコマンドは、TPM という名前のクエリメンバーシップルールを、デバイス名のデバイスコレクションWindows 10します。

Remove-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -RuleName "TPM" -Force

パラメーター

-CollectionId

ルールを削除するデバイスコレクションの ID を指定します。この値は 、CollectionID プロパティです。たとえば XYZ00012 、です。既定のコレクションからクエリルールを削除できないので、この ID はサイトコードで始まり、削除されません SMS 。

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

-CollectionName

ルールを削除するデバイスコレクションの名前を指定します。

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

-Confirm

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

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

-Force

確認を求めずにコマンドを実行します。

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

-InputObject

ルールを削除するデバイスコレクションのオブジェクトを指定します。このオブジェクトを取得するには、Get-CMCollection コマンドレットまたは Get-CMDeviceCollection コマンドレットを使用します。

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

-RuleName

コレクションから削除するクエリルールの名前を指定します。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object