Condividi tramite

Set-CMCollectionCloudSync

Modulo:
ConfigurationManager Module

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

SetByValue (Impostazione predefinita) 

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

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

-AddGroupName

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DisableWildcardHandling

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ForceWildcardHandling

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Id

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetById
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-InputObject

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

Proprietà dei parametri

Tipo:IResultObject
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Raccolta

Set di parametri

SetByValue
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specificare il nome di una raccolta da configurare.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByName
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RemoveGroupName

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TenantId

Specificare l'ID del tenant Microsoft Entra. Questo valore è la proprietà TenantId , ad esempio aaaabbbb-0000-cccc-1111-dddd2222eeee.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TenantName

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TenantObject

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

Proprietà dei parametri

Tipo:IResultObject
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object