Share via

Add-CMUserCollectionIncludeMembershipRule

  • 參考
模組:
ConfigurationManager

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

Syntax

Add-CMUserCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 將 include 成員資格規則新增至使用者集合。 include 成員資格規則包含套用規則之使用者集合的另一個集合成員。

您無法將成員資格規則新增至預設集合。 您目標的任何集合都應該有以月臺碼開頭的識別碼，而不是 SMS 。 您可以包含預設集合，因此包含之集合的識別碼可以從 開始 SMS 。

如果包含集合的成員資格變更，Configuration Manager會依排程動態更新使用者集合的成員資格。

當您將 include 成員資格規則新增至集合時，資源可能會成為集合的成員。 此動作可能會導致任何軟體或設定部署套用至包含集合中的使用者。

如需詳細資訊，請參閱如何在 Configuration Manager 中建立集合。

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：新增 include 成員資格規則

此命令會新增名為 All Users 且包含成員資格規則的使用者集合。 規則會新增至名為 Users 的使用者集合。

Add-CMUserCollectionIncludeMembershipRule -CollectionName "Users" -IncludeCollectionName "All Users"

參數

-CollectionId

指定要新增規則之使用者集合的識別碼。 這個值是CollectionID屬性，例如 。 XYZ00012 由於預設集合不包含成員資格規則，因此此識別碼會以月臺碼開頭，而不是 SMS 。

Type:String
Aliases:Id
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

指定要新增規則的使用者集合名稱。

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeCollection

指定要加入至規則之內含集合的 物件。 若要取得此物件，請使用 Get-CMCollection 或 Get-CMUserCollection Cmdlet。

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IncludeCollectionId

指定要新增至規則之內含集合的識別碼。 這個值是CollectionID屬性，例如 。 XYZ00012 您可以包含預設集合，因此這個值可以從月臺碼或 SMS 開頭。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IncludeCollectionName

指定要新增至規則的內含集合名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

指定要加入規則之使用者集合的 物件。 若要取得此物件，請使用 Get-CMCollection 或 Get-CMUserCollection Cmdlet。

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object