New-AddressList

  • 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-AddressList para crear una nueva lista de direcciones y aplicarla a los destinatarios.

Sintaxis

New-AddressList -Name <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>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-AddressList -Name <String> [-Confirm [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Para ejecutar el cmdlet New-AddressList, se debe usar la cuenta que use debe tener delegado lo siguiente:

  • Función Administrador de la organización de Exchange

Para obtener más información sobre 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

Name

Necesario

System.String

El parámetro Name especifica el nombre deseado para la nueva lista de direcciones. El nombre no puede superar los 64 caracteres y no puede incluir retornos de carro ni barras diagonales inversas (\).

ConditionalCompany

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCompany es un filtro para especificar una compañía. Todos los destinatarios que tengan un atributo de organización que coincida con el valor que introduzca para este parámetro se incluirán en la lista de direcciones. Puede usar varios valores en forma de lista delimitada por comas. No puede usar este parámetro si usa el parámetro RecipientFilter. Debe usar el parámetro RecipientFilter o uno de estos parámetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

ConditionalCustomAttribute1

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute1 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute10

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute10 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute11

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute11 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute12

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute12 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute13

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute13 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute14

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute14 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute15

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute15 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute2

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute2 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute3

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute3 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute4

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute4 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute5

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute5 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute6

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute6 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute7

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute7 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute8

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute8 especifica atributos personalizados. Puede usar estos atributos para almacenar información adicional.

ConditionalCustomAttribute9

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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 es un filtro para especificar un departamento. Todos los destinatarios con un atributo de departamento que coincida con el valor que introduce para este parámetro estarán incluidos en la lista de direcciones. Puede usar varios valores en forma de lista delimitada por comas. No puede usar este parámetro si usa el parámetro RecipientFilter. Debe usar el parámetro RecipientFilter o uno de estos parámetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

ConditionalStateOrProvince

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalStateOrProvince es un filtro para especificar un estado o provincia. Todos los destinatarios con un atributo ConditionalStateOrProvince que coincida con el valor que introduce para este parámetro estarán incluidos en la lista de direcciones. Puede usar varios valores en forma de lista delimitada por comas. No puede usar este parámetro si usa el parámetro RecipientFilter. Debe usar el parámetro RecipientFilter o uno de estos parámetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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.

Container

Opcional

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

El parámetro Container especifica la identidad de la lista de direcciones primaria en la que se creará esta nueva lista de direcciones. Si no se especifica ninguna lista de direcciones primaria, la lista de direcciones se creará en "Todas las listas de direcciones".

DisplayName

Opcional

System.String

El parámetro DisplayName especifica el nombre para mostrar deseado de la lista de direcciones. Si no se proporciona ningún nombre para mostrar, el nombre de la lista de direcciones también será el nombre para mostrar.

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 Active Directory, incluya el parámetro DomainController del comando.

IncludedRecipients

Opcional

System.Nullable

El parámetro IncludedRecipients es un filtro para especificar el tipo de destinatario a incluir en la lista de direcciones. Puede usar uno o varios de estos tipos:

  • Ninguna

  • UserMail

  • Recursos

  • MailGroups

  • MailContacts

  • AllRecipients

No puede usar este parámetro si usa el parámetro RecipientFilter. Debe usar el parámetro RecipientFilter o uno de estos parámetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

RecipientFilter

Opcional

System.String

El parámetro RecipientFilter especifica un filtro de destinatarios para incluirlo en la lista de direcciones. No puede usar este parámetro si usa cualquiera de los siguientes parámetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Debe usar este parámetro o uno de los parámetros de filtro anteriores.

Para obtener más información acerca de propiedades filtrables, consulte Propiedades filtrables para el parámetro: RecipientFilter.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Al suministrar un objeto existente al parámetro TemplateInstance, el comando usará la configuración de ese objeto para crear un duplicado exacto del objeto en un servidor de destino o local.

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

En el primer ejemplo se muestra cómo crear una nueva lista de direcciones denominada MyAddressList. La lista de direcciones incluye destinatarios que son usuarios de buzones y tienen el atributo StateOrProvince establecido en Washington u Oregón.

El segundo ejemplo muestra cómo crear una nueva lista de direcciones denominada MyAddressList2 que incluya buzones que tienen el parámetro ConditionalStateOrProvince definido en Washington.

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers