New-DistributionGroup

  • Artículo

 

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

Última modificación del tema: 2009-05-12

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

Sintaxis

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

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 operadores 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 Name y DisplayName son distintos:

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

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.

Type

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.

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.

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 (FQDN) del controlador de dominio que escribe este cambio de configuración en 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 cualquiera de los siguientes valores para este parámetro:

  • Nombre distintivo (DN)

  • Nombre canónico

  • GUID

  • Nombre

  • Nombre para mostrar

  • DN de Exchange heredado

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

OrganizationalUnit

Opcional

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.

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.

UseRusServer

Opcional

System.String
noteNota:
Este parámetro sólo está disponible en Exchange Server 2007 SP2.

El parámetro UseRusServer indica al comando que use el servidor de buzones especificado en el que se esté ejecutando el servicio Lista de direcciones para obtener y establecer los atributos del buzón y del usuario de Active Directory.

El servicio Lista de direcciones es un componente del servicio Operador de sistema de Exchange. El servicio Lista de direcciones crea y mantiene valores de atributo específicos de Exchange en Active Directory. El servicio Lista de direcciones se puede usar para actualizar objetos de destinatario de un dominio mediante el uso de información específica, como la pertenencia a una lista de direcciones y direcciones de correo electrónico. 

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 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"