Set-CMCollectionCloudSync

Configurare la sincronizzazione dell'appartenenza alla raccolta per Microsoft Entra gruppi per un dispositivo o una raccolta di utenti. Per altre informazioni, vedere Come sincronizzare i membri della raccolta con i gruppi Microsoft Entra

Sintassi

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

Descrizione

Usare questo cmdlet per configurare la sincronizzazione dell'appartenenza alla raccolta per Microsoft Entra gruppi per un dispositivo o una raccolta di utenti.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Abilitare una raccolta per sincronizzare i membri con Microsoft Entra gruppo

Il primo comando ottiene l'oggetto raccolta denominato testUserCollection e lo archivia nella variabile $userCollection . Il secondo comando ottiene il tenant Microsoft Entra denominato contoso e lo archivia nella variabile $AADTenant. Il terzo comando abilita la sincronizzazione della raccolta con Microsoft Entra gruppo denominato testUserGroup appartenente al nome tenant "contoso"

$userCollection = Get-CMCollection -Name "testUserCollection"
$AADTenant = Get-CMAADTenant -Name "contoso"
Set-CMCollectionCloudSync -InputObject $userCollection -AddGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantObject $AADTenant

Esempio 2: Rimuovere la sincronizzazione della raccolta con Microsoft Entra gruppo

Il primo comando ottiene l'oggetto raccolta denominato testUserCollection e lo archivia nella variabile $userCollection . Il secondo comando rimuove la sincronizzazione della raccolta con Microsoft Entra gruppo denominato testUserGroup appartenente al nome tenant "contoso", passato come valore per il parametro -TenantName. In alternativa, è possibile usare anche il parametro -TenantId.

$userCollection = Get-CMCollection -Name "testUserCollection"
Set-CMCollectionCloudSync -InputObject $userCollection -RemoveGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantName "contoso"

Parametri

-AADGroupName

Specificare il nome del gruppo di Microsoft Entra di destinazione con cui sincronizzare i membri della raccolta.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableAssignEndpointSecurityPolicy

Usare questo parametro per abilitare o disabilitare la raccolta per la visualizzazione nel portale di Intune per assegnare i criteri di sicurezza degli endpoint nello scenario di collegamento tenant.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Specificare l'ID della raccolta da configurare. Questo valore è la proprietà CollectionID , ad esempio XYZ00012.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specificare un oggetto raccolta da configurare. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specificare il nome di una raccolta da configurare.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RemoveGroupName

Usare questo parametro per rimuovere la sincronizzazione con il gruppo di Microsoft Entra specificato.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Specificare l'ID del tenant Microsoft Entra. Questo valore è la proprietà TenantId , ad esempio 72f988bf-00ab-11cd-22ef-2d7cd011db00.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantName

Specificare il nome del tenant Microsoft Entra, ad esempio contoso.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantObject

Specificare un oggetto per il tenant Microsoft Entra. Per ottenere questo oggetto, usare il cmdlet Get-CMAADTenant .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object