Add-CMUserCollectionExcludeMembershipRule
將排除成員資格規則新增至使用者集合。
Syntax
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 將排除成員資格規則新增至使用者集合。 _排除_成員資格規則會從套用規則的使用者集合中排除另一個集合的成員。
您無法將成員資格規則新增至預設集合。 您目標的任何集合都應有以網站代碼開頭的 ID SMS
。 您可以排除預設集合,所以排除的集合的識別碼可以以開頭 SMS
。
若排除的集合的成員資格變更,Configuration Manager 會以排程方式動態更新使用者集合的成員資格。
當您將 exclude 成員資格規則新增至集合時,資源可能不再是使用者集合的成員。 這種動作可能會導致任何軟體或設定部署不會套用至使用者。
如需詳細資訊,請參閱 如何在 Configuration Manager 中建立集合。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例1:將排除集合規則新增至使用者集合
這個命令會從 ID 為XYZ00012的 user 集合中,排除具有識別碼XYZ00017之遠端使用者集合的成員。
Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"
參數
-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 |
-ExcludeCollection
指定排除的集合的物件,以新增規則。 若要取得此物件,請使用 CMCollection 或 CMUserCollection Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollectionId
指定排除集合的識別碼,以新增規則。 此值為 CollectionID 屬性,例如 XYZ00012
。 您可以排除預設集合,如此一來,此值可以是以網站代碼或為開頭 SMS
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollectionName
指定排除的集合名稱,以新增規則。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定使用者集合的物件以新增規則。 若要取得此物件,請使用 CMCollection 或 CMUserCollection 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
輸出
系統.物件