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