Add-CMDeviceCollectionDirectMembershipRule
將直接成員資格規則新增至裝置集合。
Syntax
Add-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionId <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-CollectionName <String>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
-InputObject <IResultObject>
[-PassThru]
-Resource <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 可將直接成員資格規則新增至裝置集合。
_直接_成員資格規則可讓您明確選擇裝置集合的成員。
您無法將成員資格規則新增至預設集合。 您目標的任何集合都應有以網站代碼開頭的 ID SMS
。
如需詳細資訊,請參閱 如何在 Configuration Manager 中建立集合。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例1:新增直接成員資格規則
這個命令會將直接成員資格規則新增至識別碼為 XYZ00056的裝置集合。 它會將 ID 為 16777219 的資源新增至集合。
Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219
範例2:使用管線新增直接成員資格規則
此命令會先使用 CMCollection 指令程式 ,取得名為 testCollection的集合物件。 然後,它會使用管線運算子,將物件傳遞至 CMDeviceCollectionDirectMembershipRule Cmdlet,該指令程式會將直接成員資格規則新增至 device 集合物件。 它會將 ID 為 16777219 的裝置新增至集合。
Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219
參數
-CollectionId
指定裝置集合的識別碼,以新增規則。 此值為 CollectionID 屬性,例如 XYZ00012
。 因為您無法將成員資格規則新增至預設集合,所以這個識別碼會以網站程式碼為開頭 SMS
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
指定要新增規則之裝置集合的名稱。
Type: | String |
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 |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
Type: | SwitchParameter |
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 |
-Resource
使用此直接成員資格規則,指定要新增至裝置集合的 resource 物件陣列。 若要取得此物件,請使用 CMResource 指令程式 ,或使用參數的 CMDevice Cmdlet -Resource
。
Type: | IResultObject[] |
Aliases: | Resources |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
使用此直接成員資格規則,指定要新增至裝置集合的資源識別碼s 陣列。 例如,這個值是 ResourceID 屬性 16777219
。
Type: | Int32[] |
Aliases: | ResourceIds |
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
輸出
系統.物件