New-EmailAddressPolicy
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-EmailAddressPolicy para crear una nueva directiva de direcciones de correo electrónico.
Sintaxis
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -IncludedRecipients <Nullable> [-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>]] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-Confirm [<SwitchParameter>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-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>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El cmdlet New-EmailAddressPolicy crea y aplica una nueva directiva de direcciones de correo electrónico. La nueva directiva de direcciones de correo electrónico se crea en el contenedor de configuración de la organización deMicrosoft Exchange en el servicio de directorio Active Directory.
Para ejecutar el cmdlet New-EmailAddressPolicy, deberá delegar a la cuenta que utilice los elementos siguientes:
- Función Administrador de la organización de Exchange
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción | ||
|---|---|---|---|---|---|
EnabledEmailAddressTemplates |
Necesario |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
El parámetro EnabledEmailAddressesTemplates especifica las direcciones proxy habilitadas e incluidas en una directiva de direcciones de correo. Separe los distintos valores mediante comas. Es necesario que la parte de dominio de cada dirección proxy coincida con un dominio aceptado ya existente. |
||
EnabledPrimarySMTPAddressTemplate |
Necesario |
System.String |
El parámetro EnabledPrimarySMTPAddressTemplate especifica la dirección proxy habilitada e incluida en una directiva de direcciones de correo. Es necesario que la parte de dominio de cada dirección proxy coincida con un dominio aceptado ya existente. |
||
IncludedRecipients |
Necesario |
System.Nullable |
El parámetro IncludedRecipients filtra los destinatarios utilizados para definir la directiva de direcciones de correo electrónico. El valor AllRecipients únicamente se puede utilizar solo. Cuando varios valores del parámetro IncludedRecipients están separados por comas, se aplica el operador booleano OR. |
||
Name |
Necesario |
System.String |
El parámetro Name especifica el nombre de la directiva de direcciones de correo electrónico. |
||
RecipientFilter |
Necesario |
System.String |
El parámetro RecipientFilter especifica un filtro para los destinatarios que se van a incluir en la directiva de direcciones de correo electrónico. No puede utilizar este parámetro si utiliza cualquiera de los siguientes parámetros de filtro:
Para obtener más información acerca de propiedades a las que se puede aplicar un filtro, consulte Propiedades filtrables para el parámetro -RecipientFilter. |
||
ConditionalCompany |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCompany filtra por compañía. Utiliza varios valores en forma de lista delimitada por comas. |
||
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 por departamento. Utiliza varios valores en forma de lista delimitada por comas. |
||
ConditionalStateOrProvince |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalStateOrProvince filtra por estado o provincia. Toma varios valores como una lista separada mediante comas. |
||
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. |
||
DisabledEmailAddressTemplates |
Opcional |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
El parámetro DisabledEmailAddressTemplates define las direcciones proxy deshabilitadas e incluidas en una directiva de direcciones de correo. Utiliza varios valores en forma de lista delimitada por comas. |
||
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 en Active Directory, incluya el parámetro DomainController en el comando. |
||
Priority |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority |
El parámetro Priority establece la prioridad actual como prioridad superior a la especificada como un argumento para este parámetro. |
||
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 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
El siguiente código es un ejemplo del comando New-EmailAddressPolicy.
New-EmailAddressPolicy -Name "MyPolicy" -IncludedRecipients MailboxUsers -EnabledPrimarySMTPAddressTemplate SMTP:@contoso.com