Set-CMCollectionCloudSync

Configure la sincronización de pertenencia a recopilación para Microsoft Entra grupos de un dispositivo o colección de usuarios. Para obtener más información, vea How to synchronize collection members to Microsoft Entra groups

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

Description

Use este cmdlet para configurar la sincronización de pertenencia a la colección para Microsoft Entra grupos de un dispositivo o colección de usuarios.

Nota:

Ejecute Configuration Manager cmdlets desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Habilitar una colección para sincronizar miembros con Microsoft Entra grupo

El primer comando obtiene el objeto de colección denominado testUserCollection y lo almacena en la variable $userCollection . El segundo comando obtiene el inquilino Microsoft Entra denominado contoso y lo almacena en la variable $AADTenant. El tercer comando permite la sincronización de la colección con Microsoft Entra grupo denominado testUserGroup que pertenece al nombre de inquilino "contoso".

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

Ejemplo 2: Eliminación de la sincronización de recopilación con Microsoft Entra grupo

El primer comando obtiene el objeto de colección denominado testUserCollection y lo almacena en la variable $userCollection . El segundo comando quita la sincronización de la colección con Microsoft Entra grupo denominado testUserGroup que pertenece al nombre de inquilino "contoso", que se pasa como valor para el parámetro -TenantName. Como alternativa, también se puede usar el parámetro -TenantId.

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

Parámetros

-AADGroupName

Especifique el destino Microsoft Entra nombre del grupo con el que se deben sincronizar los miembros de la colección.

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

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-EnableAssignEndpointSecurityPolicy

Use este parámetro para habilitar o deshabilitar la colección para mostrarla en el portal de Intune y asignar directivas de seguridad de punto de conexión en el escenario de asociación de inquilinos.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-Id

Especifique el identificador de la colección que se va a configurar. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012.

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

-InputObject

Especifique un objeto de colección que se va a configurar. Para obtener este objeto, use los cmdlets 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

Especifique el nombre de una colección que se va a configurar.

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

-RemoveGroupName

Use este parámetro para quitar la sincronización con el grupo de Microsoft Entra especificado.

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

-TenantId

Especifique el identificador del inquilino de Microsoft Entra. Este valor es la propiedad TenantId , por ejemplo, 72f988bf-00ab-11cd-22ef-2d7cd011db00.

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

-TenantName

Especifique el nombre del inquilino de Microsoft Entra, por ejemplo, contoso.

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

-TenantObject

Especifique un objeto para el inquilino de Microsoft Entra. Para obtener este objeto, use el cmdlet Get-CMAADTenant .

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object