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, contosoz. 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