Set-CMCollectionCloudSync

  • Referencia
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