Remove-DistributionGroup

  • 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-DistributionGroup para eliminar un grupo de distribución existente del servicio de directorio de Active Directory.

Sintaxis

Remove-DistributionGroup -Identity <DistributionGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

El cmdlet Remove-DistributionGroup elimina un grupo de distribución existente del servicio de directorio de Active Directory.

Para ejecutar el cmdlet Remove-DistributionGroup, 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 quitar. El parámetro Identity puede tomar cualquiera de los siguientes valores para el grupo de distribución:

  • Nombre distintivo (DN)

  • Nombre canónico

  • GUID

  • Name

  • Nombre para mostrar

  • Alias

  • DN de Exchange heredado

  • Dirección de Protocolo simple de transferencia de correo (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.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

El parámetro IgnoreDefaultScope indica al comando que omita la opción predeterminada del ámbito de destinatario para el Shell de administración de Exchange y que utilice todo el bosque como ámbito. Esto permite que el comando tenga acceso a objetos de Active Directory que no están actualmente en el ámbito predeterminado. El uso del parámetro IgnoreDefaultScope introduce las siguientes restricciones:

  • No puede utilizar el parámetro DomainController. El comando utilizará un servidor de catálogo global adecuado automáticamente.

  • Sólo puede utilizar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.

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

El siguiente ejemplo de código muestra cómo utilizar el cmdlet Remove-DistributionGroup para quitar un grupo de distribución existente que recibe el nombre de "Temporary Staff".

Remove-DistributionGroup -Identity "Temporary Staff"