Add-CMUserCollectionExcludeMembershipRule
除外メンバーシップ ルールをユーザー コレクションに追加します。
構文
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットを使用して、除外メンバーシップ ルールをユーザー コレクションに追加します。 除外 メンバーシップ ルールは、ルールが適用されるユーザー コレクションから別のコレクションのメンバーを除外します。
既定のコレクションにメンバーシップ ルールを追加できない。 ターゲットとするコレクションには、サイト コードで始まる ID を持つ必要があります SMS 。 既定のコレクションを除外できます。そのため、除外されたコレクションの ID はで始まる可能性があります SMS 。
Configuration Manager は、除外されたコレクションのメンバーシップが変更された場合、スケジュールに基じてユーザー コレクションのメンバーシップを動的に更新します。
コレクションに除外メンバーシップ ルールを追加すると、リソースがユーザー コレクションのメンバーでなくなる可能性があります。 このアクションを実行すると、ソフトウェアまたは構成の展開がユーザーに適用されない可能性があります。
詳細については 、「Configuration Manager でコレクションを作成する方法」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 1: ユーザー コレクションに除外コレクション ルールを追加する
このコマンドは、ID XYZ00012 を持つユーザー コレクションから 、ID XYZ00017を持つリモート ユーザー コレクションのメンバーを除外します。 ****
Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"パラメーター
-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 |
-ExcludeCollection
ルールを追加する除外コレクションのオブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollection コマンドレット または Get-CMUserCollection コマンドレット を使用します。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeCollectionId
ルールを追加する除外コレクションの ID を指定します。 この値は 、CollectionID プロパティです。たとえば XYZ00012 、 です。 既定のコレクションを除外できます。この値は、サイト コードまたは SMS .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeCollectionName
ルールを追加する除外コレクションの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
ルールを追加するユーザー コレクションのオブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollection コマンドレット または Get-CMUserCollection コマンドレット を使用します。
| Type: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| Type: | SwitchParameter |
| 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