Add-CMDeviceCollectionIncludeMembershipRule
將包含成員資格規則新增至裝置集合。
Syntax
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>] Description
使用此 Cmdlet 將包含成員資格規則新增至裝置集合。 _包含_成員資格規則包含另一個集合的成員到套用此規則的裝置集合。
您無法將成員資格規則新增至預設集合。 您目標的任何集合都應有以網站代碼開頭的 ID SMS 。 您可以包含預設集合，所以包含的集合的識別碼可以以開頭 SMS 。
如果所包含集合的成員資格變更，Configuration Manager 就會在排程中動態更新裝置集合的成員資格。
當您新增包含成員資格規則至集合時，資源可能成為集合的成員。 此巨集指令可導致任何軟體或設定部署套用至包含集合中的裝置。
如需詳細資訊，請參閱 如何在 Configuration Manager 中建立集合。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。
範例
範例1：新增包含成員資格規則
這個命令會新增以包含成員資格規則命名之 所有系統 的裝置集合。 規則會新增至名為 device的裝置集合。
Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems"範例2：使用管線新增包含成員資格規則至集合
此命令會先使用 CMCollection 指令程式 ，以取得名為 Device的目標集合物件。 然後，它會使用管線運算子將物件傳遞至 CMDeviceCollectionIncludeMembershipRule Cmdlet，此指令程式會為名稱為 [ 所有系統] 的裝置集合新增包含成員資格規則。
Get-CMCollection -Name "Device" | Add-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems"參數
-CollectionId
指定裝置集合的識別碼，以新增規則。 此值為 CollectionID 屬性，例如 XYZ00012 。 因為預設集合不包含成員資格規則，所以此識別碼會以網站程式碼開頭 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
執行 Cmdlet 之前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeCollection
為包含的集合指定要新增至規則的物件。 若要取得此物件，請使用 CMCollection 或 CMDeviceCollection Cmdlet。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeCollectionId
指定包含的集合的識別碼，以新增至規則。 此值為 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
指定裝置集合的物件，以新增規則。 若要取得此物件，請使用 CMCollection 或 CMDeviceCollection Cmdlet。
| Type: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
新增此參數可傳回代表您正在使用之專案的物件。 根據預設，此 Cmdlet 可能不會產生任何輸出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
系統.物件