Add-CMUserCollectionIncludeMembershipRule
將 include 成員資格規則新增至使用者集合。
語法
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
。
類型: | String |
別名: | Id |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-CollectionName
指定要新增規則的使用者集合名稱。
類型: | String |
別名: | Name |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-IncludeCollection
指定要加入至規則之內含集合的物件。 若要取得此物件,請使用 Get-CMCollection 或 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-CMUserCollection Cmdlet。
類型: | IResultObject |
別名: | Collection |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-PassThru
新增此參數以傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 可能不會產生任何輸出。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object