Remove-DistributionGroupMember

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2007-06-28

Utilice el cmdlet Remove-DistributionGroupMember para quitar un destinatario de un grupo de distribución.

Sintaxis

Remove-DistributionGroupMember -Identity <DistributionGroupIdParameter> -Member <GeneralRecipientIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Puede utilizar el cmdlet Remove-DistributionGroupMember para quitar un destinatario de un grupo de distribución o de un grupo de seguridad habilitado para correo. No puede utilizar el cmdlet Remove-DistributionGroupMember para quitar un destinatario de un grupo de distribución dinámico. Un grupo de distribución dinámico consulta los objetos habilitados para correo de Microsoft Active Directory y crea la pertenencia al grupo basándose en los resultados. La pertenencia al grupo se recalcula siempre que se envía un mensaje de correo electrónico a dicho grupo.

Para ejecutar el cmdlet Remove-DistributionGroupMember, se debe utilizar una cuenta en la que se delegue lo siguiente:

  • Función Administrador de destinatarios de Exchange

  • Función Operador de cuenta de los contenedores de Active Directory correspondientes

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

El parámetro Identity especifica el grupo de distribución que desea modificar. El parámetro Identity puede tomar cualquiera de los valores siguientes para el grupo de distribución.

  • Nombre completo (DN)

  • Nombre canónico

  • GUID

  • Nombre

  • Nombre para mostrar

  • Alias

  • DN de Exchange heredado

  • Dirección de correo electrónico principal SMTP (Protocolo simple de transferencia de correo)

Member

Necesario

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Este parámetro especifica el destinatario que desea quitar del grupo de distribución. El parámetro Member puede tomar cualquiera de los valores siguientes para el destinatario:

  • Nombre completo (DN)

  • Nombre canónico

  • GUID

  • Nombre

  • Nombre para mostrar

  • Alias

  • DN de Exchange heredado

  • Dirección principal de correo electrónico SMTP

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en Active Directory, incluya el parámetro DomainController.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

En el siguiente ejemplo de código se muestra cómo utilizar el cmdlet Remove-DistributionGroupMember para quitar a Ted Bremer del grupo de distribución denominado Technical Support.

Remove-DistributionGroupMember -Identity "Technical Support" -Member "Ted Bremer"