New-DynamicDistributionGroup (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-10-23
Use el cmdlet New-DynamicDistributionGroup para crear un nuevo grupo de distribución dinámico.
Sintaxis
New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
New-DynamicDistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -RecipientFilter <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
Descripción detallada
Un grupo de distribución dinámica consulta los objetos habilitados para correo del servicio de directorio de Active Directory y crea la pertenencia a grupos en función de los resultados. La pertenencia a grupos se vuelve a calcular siempre que se envía un mensaje de correo electrónico al grupo. Los filtros de consulta que proporciona Exchange se limitan a cualquier combinación de los siguientes parámetros:
ConditionalCompany
ConditionalCustomAttribute N (donde N es un valor de 1 a 15)
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients
También puede crear consultas personalizadas mediante el parámetro RecipientFilter.
Para ejecutar el cmdlet New-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 Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
IncludedRecipients |
Necesario |
System.Nullable |
El parámetro IncludedRecipients filtra los tipos de destinatario que se usan para crear el grupo de distribución dinámica. El parámetro IncludedRecipients no se puede usar si se especifica el parámetro RecipientFilter. Los valores disponibles para el parámetro IncludedRecipients son AllRecipients, MailboxUsers, Resources, MailContacts, MailGroups, Mail Users y None. AllRecipients únicamente se puede usar solo. Cuando varios valores de IncludedRecipients se separan mediante comas, se aplica el operador booleano OR. |
Name |
Necesario |
System.String |
El parámetro Name especifica el nombre del grupo de distribución dinámica. Si no se especifica el parámetro DisplayName, el valor de Name también se usa para DisplayName. El valor Name no puede superar los 64 caracteres. Si los valores de Name y DisplayName son diferentes:
|
OrganizationalUnit |
Necesario |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
El parámetro OrganizationalUnit especifica dónde crear el grupo de distribución dinámico en Active Directory mediante una sintaxis de nombre canónico. |
RecipientFilter |
Necesario |
System.String |
El parámetro RecipientFilter filtra los destinatarios habilitados para correo que se usan para crear el grupo de distribución dinámica. RecipientFilter no se puede usar si se especifica cualquiera de los siguientes parámetros:
RecipientFilter usa una sintaxis Para obtener más información acerca de propiedades filtrables, consulte Propiedades filtrables para el parámetro: RecipientFilter. |
Alias |
Opcional |
System.String |
El parámetro Alias especifica el alias del grupo de distribución dinámica. El valor de Alias se usa para generar la dirección de correo electrónico principal del Protocolo simple de transferencia de correo (SMTP) para el grupo de distribución dinámico. El valor de Alias no puede contener espacios. Si no se especifica el parámetro Alias, el valor del parámetro Name se usa para el valor del parámetro Alias, con cualquier espacio del parámetro Name convertido en caracteres subrayados (_). |
ConditionalCompany |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCompany filtra los usuarios del buzón o los contactos habilitados para correo que se usan para crear el grupo de distribución dinámica. Cuando varios valores del parámetro ConditionalCompany están separados por comas, se aplica el operador booleano OR. |
ConditionalCustomAttribute1 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute1 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute10 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute10 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute11 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute11 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute12 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute12 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute13 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute13 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute14 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute14 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute15 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute15 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute2 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute2 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute3 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute3 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute4 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute4 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute5 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute5 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute6 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute6 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute7 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute7 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute8 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute8 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalCustomAttribute9 |
Opcional |
System.String |
El parámetro ConditionalCustomAttribute9 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional. |
ConditionalDepartment |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalDepartment filtra los usuarios del buzón o los contactos habilitados para correo que se usan para crear el grupo de distribución dinámica. ConditionalDepartment no se puede usar si se especifica el parámetro RecipientFilter. Cuando varios valores de ConditionalDepartment se separan mediante comas, se aplica el operador booleano OR. |
ConditionalStateOrProvince |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalStateOrProvince filtra los usuarios del buzón o los contactos habilitados para correo que se usan para crear el grupo de distribución dinámica. ConditionalStateOrProvince no se puede usar si se especifica el parámetro RecipientFilter. Cuando varios valores de ConditionalStateOrProvince se separan mediante comas, se aplica el operador booleano OR. |
DisplayName |
Opcional |
System.String |
El parámetro DisplayName especifica el nombre del grupo de distribución dinámica de la Consola de administración de Exchange y la lista global de direcciones (LGD) de Exchange. Si no se especifica el parámetro DisplayName, el valor del parámetro Name se usa 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. |
RecipientContainer |
Opcional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
El parámetro RecipientContainer filtra los destinatarios que se usan para crear el grupo de distribución dinámica en función de su ubicación en Active Directory. El valor de RecipientContainer puede ser el nombre canónico de una unidad organizativa (OU) o un dominio. Si no se especifica un valor para RecipientContainer, el filtro de búsqueda predeterminado es la ubicación del grupo de distribución dinámica de Active Directory. Esta ubicación se especifica mediante el parámetro OrganizationalUnit. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Cuando se suministra un objeto existente al parámetro TemplateInstance, el comando usa la configuración de este objeto para crear una copia de dicho objeto. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
Los siguientes ejemplos de código muestran cómo usar el comando New-DynamicDistributionGroup.
El primer ejemplo crea un nuevo grupo de distribución dinámico denominado Grupo de marketing en el contenedor Usuarios del dominio Contoso.com. El grupo de distribución dinámica Grupo de marketing contiene todos los usuarios de buzón o contactos habilitados para enviar y recibir correo encontrados en cualquier parte del dominio Contoso.com que tengan un campo Departamento que contenga "Marketing" o "Ventas".
El segundo ejemplo usa el parámetro RecipientFilter para crear un grupo de distribución dinámico con el nombre "Noroeste" en el contenedor Usuarios del dominio Contoso.com. El grupo de distribución dinámico "Noroeste" contiene todos los usuarios de buzón encontrados en cualquier parte del dominio Contoso.com que tengan un campo Provincia que contenga "Zaragoza" o "Barcelona".
New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "Contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "Contoso.com"
New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias "Pacific_Northwest" -OrganizationalUnit "Contoso.com/Users" -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer "Contoso.com"