Add-CMUserCollectionExcludeMembershipRule

參考

模組:: ConfigurationManager

將排除成員資格規則新增至使用者集合。

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

輸出

系統.物件