Set-CMCollectionCloudSync
設定集合成員資格同步處理，以Microsoft裝置或使用者集合的 Entra 群組。 如需詳細資訊，請 參閱如何將集合成員同步至 Microsoft Entra 群組
語法
Set-CMCollectionCloudSync
-InputObject <IResultObject#SMS_Collection>
[-AddGroupName <string[]>][-EnableAssignEndpointSecurityPolicy <bool>]
[-RemoveGroupName <string[]>]
[-TenantId <string>][-TenantName <string>]
[-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>]
[-DisableWildcardHandling]
[-ForceWildcardHandling][-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMCollectionCloudSync
-Id <string>
[-AddGroupName <string[]>]
[-EnableAssignEndpointSecurityPolicy <bool>][-RemoveGroupName <string[]>]
[-TenantId <string>]
[-TenantName <string>]
[-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>][-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm][<CommonParameters>] Set-CMCollectionCloudSync
-Name <string>
[-AddGroupName <string[]>]
[-EnableAssignEndpointSecurityPolicy <bool>][-RemoveGroupName <string[]>]
[-TenantId <string>]
[-TenantName <string>]
[-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>][-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm][<CommonParameters>] Description
使用此 Cmdlet 來設定集合成員資格同步處理，以Microsoft裝置或使用者集合的 Entra 群組。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：讓集合將成員同步至 Microsoft Entra 群組
第一個命令會取得名為 testUserCollection的 集合物件，並將它儲存在 $userCollection 變數中。 第二個命令會取得名為 contoso 的 Microsoft Entra 租使用者，並將它儲存在 $AADTenant 變數中。 第三個命令可讓集合與名為 testUserGroup 的 Microsoft Entra 群組進行同步處理，該群組屬於租用戶名稱 “contoso”
$userCollection = Get-CMCollection -Name "testUserCollection"
$AADTenant = Get-CMAADTenant -Name "contoso"
Set-CMCollectionCloudSync -InputObject $userCollection -AddGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantObject $AADTenant範例 2：移除與 Microsoft Entra 群組的集合同步處理
第一個命令會取得名為 testUserCollection的 集合物件，並將它儲存在 $userCollection 變數中。 第二個命令會移除集合與 Microsoft Entra 群組的同步處理，此群組名為 testUserGroup ，屬於租用戶名稱 “contoso”，其會傳遞為 -TenantName 參數的值。 或者，也可以使用 -TenantId 參數。
$userCollection = Get-CMCollection -Name "testUserCollection"
Set-CMCollectionCloudSync -InputObject $userCollection -RemoveGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantName "contoso"參數
-AADGroupName
指定集合成員需要同步處理的目標Microsoft Entra 組名。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnableAssignEndpointSecurityPolicy
使用此參數可啟用或停用在 Intune 入口網站中顯示的集合，以指派租使用者附加案例中的端點安全策略。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Id
指定要設定之集合的識別碼。 這個值是 CollectionID 屬性， 例如 。 XYZ00012
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定要設定的集合物件。 若要取得此物件，請使用 Get-CMCollection、 Get-CMDeviceCollection 或 Get-CMUserCollection Cmdlet。
| 類型: | IResultObject |
| 別名: | Collection |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定要設定的集合名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RemoveGroupName
使用此參數來移除與指定之 Microsoft Entra 群組的同步處理。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TenantId
指定 Microsoft Entra 租使用者的標識碼。 這個值是 TenantId 屬性， 例如 。 72f988bf-00ab-11cd-22ef-2d7cd011db00
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TenantName
指定 Microsoft Entra 租使用者的名稱，例如 contoso
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TenantObject
指定 Microsoft Entra 租用戶的 物件。 若要取得此物件，請使用 Get-CMAADTenant Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object