Set-CMCollectionCloudSync
Konfigurieren Sie die Synchronisierung der Sammlungsmitgliedschaft mit 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 Synchronisierung der Sammlungsmitgliedschaft mit Microsoft Entra-Gruppen für ein Gerät oder eine Benutzersammlung zu konfigurieren.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Aktivieren einer Sammlung zum Synchronisieren von Mitgliedern mit der 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 aktiviert die Synchronisierung der Sammlung mit der Microsoft Entra-Gruppe 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 $AADTenantBeispiel 2: Entfernen der Sammlungssynchronisierung mit der Microsoft Entra-Gruppe
Der erste Befehl ruft das Auflistungsobjekt mit dem Namen testUserCollection ab und speichert es in der variablen $userCollection . Mit dem zweiten Befehl wird die Synchronisierung der Sammlung mit der Microsoft Entra-Gruppe testUserGroup entfernt, 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 den Microsoft Entra-Zielgruppennamen an, mit dem die Mitglieder der Sammlung synchronisiert werden müssen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableAssignEndpointSecurityPolicy
Verwenden Sie diesen Parameter, um die Sammlung im Intune-Portal zu aktivieren oder zu deaktivieren, um Endpunktsicherheitsrichtlinien im Mandantenanfügungsszenario zuzuweisen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Id
Geben Sie die ID der zu konfigurierenden Sammlung an. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012. .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein zu konfigurierende Sammlungsobjekt an. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMCollection, Get-CMDeviceCollection oder Get-CMUserCollection .
| Typ: | IResultObject |
| Aliase: | Collection |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie den Namen einer zu konfigurierenden Sammlung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RemoveGroupName
Verwenden Sie diesen Parameter, um die Synchronisierung mit der angegebenen Microsoft Entra-Gruppe zu entfernen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TenantId
Geben Sie die ID des Microsoft Entra-Mandanten an. Dieser Wert ist die TenantId-Eigenschaft , z. B 72f988bf-00ab-11cd-22ef-2d7cd011db00. .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TenantName
Geben Sie den Namen des Microsoft Entra-Mandanten an, z. B contoso. .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TenantObject
Geben Sie ein Objekt für den Microsoft Entra-Mandanten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMAADTenant .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object