Add-CMDeviceCollectionIncludeMembershipRule
デバイス コレクションに include メンバーシップ ルールを追加します。
構文
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、デバイス コレクションに含めるメンバーシップ ルールを追加します。 include メンバーシップ ルール には、ルールが適用されるデバイス コレクションに別のコレクションのメンバーが含まれます。
既定のコレクションにメンバーシップ ルールを追加できない。 ターゲットとするコレクションには、サイト コードで始まる ID を持つ必要があります SMS
。 既定のコレクションを含め、含まれているコレクションの ID はで始めできます SMS
。
Configuration Manager は、含まれるコレクションのメンバーシップが変更された場合、スケジュールに基じてデバイス コレクションのメンバーシップを動的に更新します。
include メンバーシップ ルールをコレクションに追加すると、リソースがコレクションのメンバーになる可能性があります。 このアクションを実行すると、付属のコレクション内のデバイスにソフトウェアまたは構成の展開が適用される可能性があります。
詳細については 、「Configuration Manager でコレクションを作成する方法」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: include メンバーシップ ルールを追加する
このコマンドは、すべてのシステムという名前の デバイス コレクションに、含 めるメンバーシップ ルールを追加します。 ルールは Device という名前のデバイス コレクションに追加 されます。
Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems"
例 2: パイプラインを使用して、コレクションに include メンバーシップ ルールを追加する
このコマンドは、 まず Get-CMCollection コマンドレットを使用して、Device という名前のターゲット コレクション オブジェクトを 取得します。 次に、パイプライン 演算子を使用してオブジェクトを Add-CMDeviceCollectionIncludeMembershipRule コマンドレットに渡し、All Systemsという名前のデバイス コレクションの include メンバーシップ ルールを追加します。
Get-CMCollection -Name "Device" | Add-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems"
パラメーター
-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 |
-IncludeCollection
ルールに追加する含まれるコレクションのオブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollection コマンドレット または Get-CMDeviceCollection コマンドレット を使用します。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionId
ルールに追加する含まれるコレクションの ID を指定します。 この値は 、CollectionID プロパティです。たとえば XYZ00012
、 です。 既定のコレクションを含め、この値はサイト コードまたは SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionName
ルールに追加する含まれるコレクションの名前を指定します。
Type: | String |
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 |
-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