Remove-DynamicDistributionGroup

  • Artículo

 

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

Última modificación del tema: 2007-09-27

Use el cmdlet Remove-DynamicDistributionGroup para eliminar un grupo de distribución dinámico existente.

Sintaxis

Remove-DynamicDistributionGroup -Identity <DynamicGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Puede usar el cmdlet Remove-DynamicDistributionGroup para eliminar un grupo de distribución dinámico existente.

Para ejecutar el cmdlet Remove-DynamicDistributionGroup, la cuenta que use debe tener delegadas las siguientes funciones:

  • Función Administrador de destinatarios de Exchange

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.DynamicGroupIdParameter

El parámetro Identity se usa para identificar el grupo de distribución dinámico que quiere eliminar. El parámetro Identity puede incluir cualquiera de los siguientes valores para el grupo de distribución dinámico:

  • Nombre distintivo (DN)

  • Nombre canónico

  • GUID

  • Nombre

  • Nombre para mostrar

  • Alias

  • DN de Exchange heredado

  • Dirección de correo electrónico primaria 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

El parámetro DomainController especifica el nombre de dominio completo del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory.

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 use 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 usar el parámetro DomainController. El comando usará un servidor de catálogo global adecuado automáticamente.

  • Sólo puede usar 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 usar el cmdlet Remove-DynamicDistributionGroup para eliminar un grupo de distribución dinámico con el nombre Usuarios de prueba usando su nombre.

Remove-DynamicDistributionGroup -Identity "Test Users"