Compartir a través de


New-AddressList (RTM)

 

Se aplica a: Exchange Server 2007

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

Use el cmdlet New-AddressList para crear una nueva lista de direcciones y aplicarla a los destinatarios.

Sintaxis

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

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

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

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

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 utiliza 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 utiliza la configuración de ese objeto para crear un duplicado exacto del objeto en un servidor local o de destino.

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