Set-CMCollectionCloudSync
Konfigurieren Sie die Sammlungsmitgliedschaftssynchronisierung für Microsoft Entra Gruppen für ein Gerät oder eine Benutzersammlung. Weitere Informationen finden Sie unter Synchronisieren von Sammlungsmitgliedern mit Microsoft Entra Gruppen.
Syntax
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>]
Beschreibung
Verwenden Sie dieses Cmdlet, um die Sammlungsmitgliedschaftssynchronisierung für Microsoft Entra Gruppen für ein Gerät oder eine Benutzersammlung zu konfigurieren.
Hinweis
Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>
B. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Aktivieren einer Sammlung zum Synchronisieren von Mitgliedern mit Microsoft Entra Gruppe
Der erste Befehl ruft das Auflistungsobjekt mit dem Namen testUserCollection ab und speichert es in der variablen $userCollection . Der zweite Befehl ruft den Microsoft Entra Mandanten mit dem Namen contoso ab und speichert ihn in der variablen $AADTenant. Der dritte Befehl ermöglicht die Synchronisierung der Sammlung mit Microsoft Entra Gruppe namens testUserGroup, die zum Mandantennamen "contoso" gehört.
$userCollection = Get-CMCollection -Name "testUserCollection"
$AADTenant = Get-CMAADTenant -Name "contoso"
Set-CMCollectionCloudSync -InputObject $userCollection -AddGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantObject $AADTenant
Beispiel 2: Entfernen der Sammlungssynchronisierung mit Microsoft Entra Gruppe
Der erste Befehl ruft das Auflistungsobjekt mit dem Namen testUserCollection ab und speichert es in der variablen $userCollection . Der zweite Befehl entfernt die Synchronisierung der Sammlung mit Microsoft Entra Gruppe namens testUserGroup, die zum Mandantennamen "contoso" gehört, der als Wert für den Parameter "-TenantName" übergeben wird. Alternativ kann auch der Parameter -TenantId verwendet werden.
$userCollection = Get-CMCollection -Name "testUserCollection"
Set-CMCollectionCloudSync -InputObject $userCollection -RemoveGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantName "contoso"
Parameter
-AADGroupName
Geben Sie ziel Microsoft Entra Gruppennamen an, mit dem die Mitglieder der Sammlung synchronisiert werden müssen.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAssignEndpointSecurityPolicy
Verwenden Sie diesen Parameter, um die Sammlung im Intune-Portal zu aktivieren oder zu deaktivieren, um Endpunktsicherheitsrichtlinien im Mandantenanfügungsszenario zuzuweisen.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Geben Sie die ID der zu konfigurierenden Sammlung an. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012
. .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Geben Sie ein zu konfigurierende Sammlungsobjekt an. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMCollection, Get-CMDeviceCollection oder Get-CMUserCollection .
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Geben Sie den Namen einer zu konfigurierenden Sammlung an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveGroupName
Verwenden Sie diesen Parameter, um die Synchronisierung mit der angegebenen Microsoft Entra Gruppe zu entfernen.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantId
Geben Sie die ID des Microsoft Entra Mandanten an. Dieser Wert ist die TenantId-Eigenschaft , z. B 72f988bf-00ab-11cd-22ef-2d7cd011db00
. .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantName
Geben Sie den Namen des Microsoft Entra Mandanten an, contoso
z. B. .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantObject
Geben Sie ein Objekt für den Microsoft Entra Mandanten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMAADTenant .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für