Set-CMCollectionCloudSync

Módulo:

ConfigurationManager

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

Sintaxis

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 colecciones con grupos de Microsoft Entra para un dispositivo o colección de usuarios.

Nota:

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

Ejemplos

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

El primer comando obtiene el objeto de colección denominado testUserCollection y lo almacena en la variable $userCollection . El segundo comando obtiene el inquilino de Microsoft Entra denominado contoso y lo almacena en la variable $AADTenant . El tercer comando permite la sincronización de la colección con el grupo Microsoft Entra 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 el grupo Microsoft Entra

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 el grupo Microsoft Entra 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 nombre del grupo de Microsoft Entra de destino con el que se deben sincronizar los miembros de la colección.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Id

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 .

Tipo:	IResultObject
Alias:	Collection
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveGroupName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TenantId

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TenantName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TenantObject

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

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Vínculos relacionados

• Get-CMCollection
• Get-CMDeviceCollection
• Get-CMUserCollection
• Get-CMAADTenant
• Cómo sincronizar los miembros de la colección con grupos de Microsoft Entra