Remove-CMCollectionIncludeMembershipRule
從裝置或使用者集合中移除 include 成員資格規則。
語法
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollection <IResultObject>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionName <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 從裝置或使用者集合中移除 include 成員資格規則。 include 成員資格規則包含套用規則之集合中另一個集合的成員。
如需詳細資訊,請 參閱如何在 Configuration Manager 中建立集合。
當您移除集合的 include 成員資格規則時,資源可能不再是集合的成員。 此動作可能會導致任何軟體或設定部署不適用於資源。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:移除 include 成員資格規則
此命令會從名為 Devices 的裝置集合中移除 All Systems 集合的 include 成員資格規則。 指定 Force 參數表示移除成員資格規則,而不會提示您。
Remove-CMCollectionIncludeMembershipRule -CollectionName "Devices" -IncludeCollectionName "All Systems" -Force
範例 2:使用管線移除 include 成員資格規則
此命令會先使用 Get-CMCollection Cmdlet 來取得名為 Users 的使用者集合物件。 然後,它會使用管線運算符將對象傳遞至 Remove-CMCollectionIncludeMembershipRule Cmdlet。
Get-CMCollection -Name "Users" | Remove-CMCollectionIncludeMembershipRule -IncludeCollectionName "All Users" -Force
參數
-CollectionId
指定要移除規則之集合的識別碼。 這個值是 CollectionID 屬性, 例如 。 XYZ00012
由於預設集合不包含成員資格規則,因此此識別碼會以月臺碼開頭,而不是 SMS
。
類型: | String |
別名: | Id |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-CollectionName
指定要移除規則的集合名稱。
類型: | String |
別名: | Name |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
執行命令而不要求確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-IncludeCollection
指定包含之集合的物件,以移除規則。 若要取得此物件,請使用 Get-CMCollection、 Get-CMDeviceCollection 或 Get-CMUserCollection Cmdlet。
類型: | IResultObject |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-IncludeCollectionId
指定要移除規則之內含集合的標識碼。 這個值是 CollectionID 屬性, 例如 。 XYZ00012
您可以包含預設集合,因此這個值可以從月臺碼或 SMS
開頭。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-IncludeCollectionName
指定要移除規則的內含集合名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定要移除規則之集合的物件。 若要取得此物件,請使用 Get-CMCollection、 Get-CMDeviceCollection 或 Get-CMUserCollection Cmdlet。
類型: | IResultObject |
別名: | Collection |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object
備註
此 Cmdlet 類似於 Remove-CMDeviceCollectionIncludeMembershipRule 和 Remove-CMUserCollectionIncludeMembershipRule,這是集合類型專屬的。 此 Cmdlet 適用於裝置或使用者集合。
相關連結
- Get-CMCollectionIncludeMembershipRule
- Remove-CMCollectionDirectMembershipRule
- Remove-CMCollectionExcludeMembershipRule
- Remove-CMCollectionQueryMembershipRule
- Add-CMDeviceCollectionIncludeMembershipRule
- Add-CMUserCollectionIncludeMembershipRule
- Get-CMDeviceCollectionIncludeMembershipRule
- Get-CMUserCollectionIncludeMembershipRule
- Get-CMCollection
- Get-CMDeviceCollection
- Get-CMUserCollection
- 如何在 Configuration Manager 中建立集合