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
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de