New-DynamicDistributionGroup
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-DynamicDistributionGroup para crear un nuevo grupo de distribución dinámico.
Sintaxis
New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-DynamicDistributionGroup -Name <String> -RecipientFilter <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
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 utilice debe tener delegadas las siguientes funciones:
- Función Administrador de destinatarios de Exchange
Para obtener más información sobre los permisos, funciones de delegación y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Type | Descripción | ||
|---|---|---|---|---|---|
IncludedRecipients |
Necesario |
System.Nullable |
El parámetro IncludedRecipients filtra los tipos de destinatario que se utilizan 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 utilizar 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 utiliza para DisplayName. El valor Name no puede superar los 64 caracteres. Si los valores de Name y DisplayName son diferentes:
|
||
RecipientFilter |
Necesario |
System.String |
El parámetro RecipientFilter filtra los destinatarios habilitados para correo que se utilizan para crear el grupo de distribución dinámica. RecipientFilter no se puede utilizar 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 utilizan 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 |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute1 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute10 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute10 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute11 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute11 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute12 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute12 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute13 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute13 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute14 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute14 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute15 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute15 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute2 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute2 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute3 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute3 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute4 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute4 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute5 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute5 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute6 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute6 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute7 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute7 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute8 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute8 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
ConditionalCustomAttribute9 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCustomAttribute9 especifica atributos personalizados. Puede utilizar 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 utilizan para crear el grupo de distribución dinámica. ConditionalDepartment no se puede utilizar 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 utilizan para crear el grupo de distribución dinámica. ConditionalStateOrProvince no se puede utilizar si se especifica el parámetro RecipientFilter. Cuando varios valores de ConditionalStateOrProvince se separan mediante comas, se aplica el operador booleano OR. |
||
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 |
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 de direcciones global (GAL) de Exchange. Si no se especifica el parámetro DisplayName, el valor del parámetro Name también 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. |
||
OrganizationalUnit |
Opcional |
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. |
||
RecipientContainer |
Opcional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
El parámetro RecipientContainer filtra los destinatarios que se utilizan 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 utiliza la configuración de este objeto para crear una copia de dicho objeto. |
||
UseRusServer |
Opcional |
System.String |
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. |
.gif "note")
Nota: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 utiliza 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"