Freigeben über

Set-CMCollectionCloudSync

Modul:
ConfigurationManager Module

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

SetByValue (Standard) 

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>]

SetById 

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>]

SetByName 

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

-AddGroupName

Geben Sie ziel Microsoft Entra Gruppennamen an, mit dem die Mitglieder der Sammlung synchronisiert werden müssen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EnableAssignEndpointSecurityPolicy

Verwenden Sie diesen Parameter, um die Sammlung zu aktivieren oder zu deaktivieren, damit sie im Intune-Portal angezeigt wird, um Endpunktsicherheitsrichtlinien im Mandantenanfügungsszenario zuzuweisen.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Geben Sie die ID der zu konfigurierenden Sammlung an. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012. .

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetById
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Geben Sie ein zu konfigurierende Sammlungsobjekt an. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMCollection, Get-CMDeviceCollection oder Get-CMUserCollection .

Parametereigenschaften

Typ:IResultObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Auflistung

Parametersätze

SetByValue
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Geben Sie den Namen einer zu konfigurierenden Sammlung an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByName
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RemoveGroupName

Verwenden Sie diesen Parameter, um die Synchronisierung mit der angegebenen Microsoft Entra Gruppe zu entfernen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TenantId

Geben Sie die ID des Microsoft Entra Mandanten an. Dieser Wert ist die TenantId-Eigenschaft , z. B aaaabbbb-0000-cccc-1111-dddd2222eeee. .

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TenantName

Geben Sie den Namen des Microsoft Entra Mandanten an, contosoz. B. .

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TenantObject

Geben Sie ein Objekt für den Microsoft Entra Mandanten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMAADTenant .

Parametereigenschaften

Typ:IResultObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object