Add-CMDeviceCollectionDirectMembershipRule
將直接成員資格規則新增至裝置集合。
語法
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 將直接成員資格規則新增至裝置集合。
直接成員資格規則可讓您明確選擇裝置集合的成員。
您無法將成員資格規則新增至預設集合。 您目標的任何集合都應該有以月臺碼開頭的識別碼,而不是 SMS。
如需詳細資訊,請 參閱如何在 Configuration Manager 中建立集合。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:新增直接成員資格規則
此命令會將直接成員資格規則新增至標識 碼XYZ00056的裝置集合。 它會將標識 碼16777219 的資源新增至集合。
Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219
範例 2:使用管線新增直接成員資格規則
此命令會先使用 Get-CMCollection Cmdlet 來取得名為 testCollection 的集合物件。 然後,它會使用管線運算符將對象傳遞至 Add-CMDeviceCollectionDirectMembershipRule Cmdlet,這會將直接成員資格規則新增至裝置集合物件。 它會將標識 碼16777219 的裝置新增至集合。
Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219
參數
-CollectionId
指定要新增規則之裝置集合的標識碼。 這個值是 CollectionID 屬性, 例如 。 XYZ00012 因為您無法將成員資格規則新增至預設集合,所以此識別元會以月臺碼開頭,而不是 SMS。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
指定要新增規則的裝置集合名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定要新增規則之裝置集合的物件。 若要取得此物件,請使用 Get-CMCollection 或 Get-CMDeviceCollection Cmdlet。
| 類型: | IResultObject |
| 別名: | Collection |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PassThru
新增此參數以傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 可能不會產生任何輸出。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Resource
使用此直接成員資格規則,指定要新增至裝置集合的資源物件數位。 若要取得此物件,請使用 Get-CMResource Cmdlet 或 Get-CMDevice Cmdlet 搭配 -Resource 參數。
| 類型: | IResultObject[] |
| 別名: | Resources |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ResourceId
使用此直接成員資格規則,指定要新增至裝置集合的資源標識符陣列。 這個值是 ResourceID 屬性,例如 16777219。
| 類型: | Int32[] |
| 別名: | ResourceIds |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object