New-AddressList
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:
|
||
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:
|
||
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:
|
||
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:
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 usa 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 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 |
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
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