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
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per