Condividi tramite

Set-CMCollectionCloudSync

  • Riferimento
Modulo:
ConfigurationManager

Configurare la sincronizzazione dell'appartenenza alla raccolta con i gruppi di Microsoft Entra per una raccolta di dispositivi o utenti. Per altre informazioni, vedere Come sincronizzare i membri della raccolta con i gruppi di 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 con i gruppi di Microsoft Entra per un dispositivo o una raccolta di utenti.

Nota

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

Esempio

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

Il primo comando ottiene l'oggetto raccolta denominato testUserCollection e lo archivia nella variabile $userCollection . Il secondo comando ottiene il tenant di Microsoft Entra denominato contoso e lo archivia nella variabile $AADTenant . Il terzo comando abilita la sincronizzazione della raccolta con il gruppo Microsoft Entra denominato testUserGroup appartenente al nome del 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 il gruppo Microsoft Entra

Il primo comando ottiene l'oggetto raccolta denominato testUserCollection e lo archivia nella variabile $userCollection . Il secondo comando rimuove la sincronizzazione della raccolta con il gruppo Microsoft Entra denominato testUserGroup appartenente al nome tenant "contoso", che viene 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 Microsoft Entra di destinazione con cui sincronizzare i membri della raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

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

Tipo:IResultObject
Alias:Collection
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specificare il nome di una raccolta da configurare.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveGroupName

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TenantId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TenantName

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TenantObject

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

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object