Update-RoleGroupMember

Update-RoleGroupMember
    [-Identity] <RoleGroupIdParameter>
    [-BypassSecurityGroupManagerCheck]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Members <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

El cmdlet Update-RoleGroupMember permite reemplazar la lista completa de miembros de un grupo de roles o agregar o eliminar varios miembros mediante una programación simultánea. La lista de pertenencia que usted especifique con el parámetro Members de este cmdlet reemplaza la lista de pertenencia para el grupo de roles específico. Por este motivo, tenga cuidado al usar este cmdlet para no sobrescribir por error la pertenencia a grupos de roles.

Los cmdlet Add-RoleGroupMember y Remove-RoleGroupMember se pueden usar para agregar o quitar miembros de un grupo de roles. Puede combinar estos cmdlets con otros cmdlets, por ejemplo, Get-Mailbox, para agregar o quitar a varios miembros sin sobrescribir toda la lista de pertenencia a la vez.

Si la propiedad ManagedBy se rellena con administradores de grupos de roles, la pertenencia a grupos de roles de actualización de usuarios debe ser un administrador de grupos de roles. O bien, si el usuario es miembro del grupo de roles de administración de la organización o está asignado directa o indirectamente a las funciones de administración de las funciones, el modificador BypassSecurityGroupManagerCheck puede invalidar la comprobación de administración del grupo de seguridad.

Si el grupo de roles es un grupo de roles vinculado, no puede usar el cmdlet Update-RoleGroupMember para modificar a los miembros del grupo de roles. En su lugar, deberá modificar los miembros del grupo de seguridad universal (USG) externo que está vinculado con el grupo de roles vinculado. Para encontrar el USG externo vinculado a un grupo de roles, use el cmdlet Get-RoleGroup.

Para obtener más información acerca de los grupos de roles, consulte Descripción de los grupos de roles de administración.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Update-RoleGroupMember "Recipient Administrators" -Members "Mark", "Jane", "Mary", "Fred"

En este ejemplo se establece la lista de pertenencia al grupo de roles Administradores de destinatarios en Mark, Jane, Mary y Fred.

Update-RoleGroupMember "Recipient Administrators" -Members "Mark", "Jane", "Mary", "Fred" -BypassSecurityGroupManagerCheck

En este ejemplo se establece la lista de pertenencia al grupo de roles Administradores de destinatarios en Mark, Jane, Mary y Fred. Debido a que el usuario que ejecuta el comando no se agregó a la propiedad ManagedBy del grupo de roles, debe usarse el modificador BypassSecurityGroupManagerCheck. Se asigna el rol Administración de roles al usuario, que permite al usuario eludir la comprobación del administrador del grupo de seguridad.

Update-RoleGroupMember "Organization Management" -Members @{Add=(Get-Mailbox David).Identity, (Get-Group "Help Desk Managers").Identity

Remove=(Get-Mailbox "Christine").Identity, (Get-Mailbox "Isabel").Identity}

Este ejemplo agrega y quita varios miembros de un grupo de roles sin reemplazar a todos los miembros existente en el grupo. En este ejemplo se usa la sintaxis de propiedades multivalor descrita en Modificación de propiedades multivalor. Al usar esta sintaxis de propiedad multivalor, debe recuperar manualmente la identidad del buzón o grupo de seguridad habilitado para correo que desea agregar o quitar del grupo de roles. Utilice la sintaxis que coincida con el tipo de objeto que desee agregar o quitar:

Buzón de correo: si desea agregar o quitar un buzón de correo, use la sintaxis (Get-Mailbox "<Alias or Name>").Identity.

Grupo de seguridad habilitado para correo: si desea agregar o quitar un grupo de seguridad habilitado para correo, use la sintaxis (Get-Group "<Name>").Identity.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.