New-DistributionGroup (RTM)

 

Se aplica a: Exchange Server 2007

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

Utilice el cmdlet New-DistributionGroup para crear un nuevo grupo de distribución.

Sintaxis

New-DistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -SamAccountName <String> -Type <Distribution | Security> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-TemplateInstance <PSObject>]

Descripción detallada

Puede utilizar el cmdlet New-DistributionGroup para crear nuevos objetos de grupo de Active Directory de los siguientes tipos:

  • Grupo de seguridad universal habilitado para correo

  • Grupo de distribución universal

Los grupos de distribución se utilizan para consolidar grupos de destinatarios en un punto único de contacto para los mensajes de correo electrónico. Los grupos de distribución no pueden utilizarse para asignar permisos a los recursos de red en el servicio de directorio de Active Directory.

Para ejecutar el cmdlet New-DistributionGroup, la cuenta utilizada debe tener delegado lo siguiente:

  • Función Administrador de destinatarios de Exchange

  • Función de operador de cuentas para los contenedores de Active Directory aplicables

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

Name

Necesario

System.String

Este parámetro especifica el nombre del nuevo grupo de distribución. El valor que se especifica en el parámetro Name se utiliza igualmente para DisplayName cuando el parámetro DisplayName no se ha especificado.

El valor Name no puede superar los 64 caracteres.

Si los valores de Name y DisplayName son diferentes:

  • Name especifica el nombre del grupo de distribución en usuarios y equipos de Active Directory y también en el campo Nombre de grupo en la Consola de administración de Exchange.

  • DisplayName especifica el nombre del grupo de distribución en la Consola de administración de Exchange y en la lista global de direcciones (GAL) de Exchange.

OrganizationalUnit

Necesario

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Este parámetro especifica dónde crear el grupo de distribución en Active Directory mediante la sintaxis de nombre canónico.

SamAccountName

Necesario

System.String

Este parámetro especifica el nombre para los clientes del objeto que ejecutan sistemas operativos más antiguos. El parámetro SamAccountName se muestra en Active Directory y la Consola de administración de Exchange en el campo Nombre de grupo (anterior a Windows 2000). Si no se especifica el parámetro Alias, las siguientes condiciones son ciertas:

  • El valor SAMAccountName se utiliza para el valor del parámetro Alias, con cualquier espacio convertido en caracteres de subrayado.

  • SAMAccountName, con cualquier espacio convertido en caracteres de subrayado, se utiliza para generar la dirección de correo electrónico principal del Protocolo simple de transferencia de correo (SMTP) del objeto.

Tipo

Necesario

Microsoft.Exchange.Management.RecipientTasks.GroupType

Este parámetro especifica el tipo de grupo que se creará en Active Directory. El ámbito del grupo es siempre universal. Los valores válidos son Distribution o Security.

Alias

Opcional

System.String

Este parámetro puede utilizarse para especificar el alias del grupo de distribución. El parámetro Alias se utiliza, a continuación, para generar la dirección de correo electrónico del SMTP del objeto. El valor de Alias no puede contener espacios. Si no se especifica Alias, el valor de SAMAccountName se utiliza para generar la dirección de correo electrónico principal del SMTP , con cualquier espacio convertido en caracteres de subrayado.

DisplayName

Opcional

System.String

Este parámetro puede utilizarse para especificar el nombre del grupo de distribución en la Consola de administración de Exchange y en la lista global de direcciones (GAL) de Exchange. Si el parámetro DisplayName no se especifica, el valor del parámetro Name se utiliza para DisplayName.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

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

ManagedBy

Opcional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Este parámetro puede utilizarse para especificar el nombre del usuario del buzón, el grupo habilitado para correo o el contacto habilitado para correo que aparece en la ficha Administrado por del objeto de Active Directory. Puede utilizar los siguientes valores para este parámetro:

  • Nombre completo (DN)

  • Nombre canónico

  • GUID

  • Name

  • Nombre para mostrar

  • DN de Exchange heredado

  • Dirección principal de correo electrónico del SMTP

TemplateInstance

Opcional

System.Management.Automation.PSObject

Cuando se suministra un objeto existente a este parámetro, el cmdlet utiliza ese objeto para crear una copia de ese objeto.

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 New-DistributionGroup para crear un grupo de seguridad universal habilitado para correo que tenga los siguientes parámetros:

  • El nombre del grupo será "Administradores".

  • El grupo se creará en el contenedor de usuarios en el dominio Contoso.com.

  • El nombre de la cuenta SAM del grupo será "Administradores".

  • El tipo de grupo será Security.

New-DistributionGroup -Name "Managers" -OrganizationalUnit "contoso.com/Users" -SAMAccountName "Managers" -Type "Security"