Compartilhar via


New-EmailAddressPolicy

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2009-05-12

Use o cmdlet New-EmailAddressPolicy para criar uma nova diretiva de endereço de email.

Sintaxe

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

Descrição detalhada

O cmdlet New-EmailAddressPolicy cria uma nova diretiva de endereço de email e a aplica. A nova diretiva de endereço de email é criada no contêiner de configuração da organização do Microsoft Exchange no serviço de diretório do Active Directory.

Para executar o cmdlet New-EmailAddressPolicy, deve ser delegado à conta que você usa deve ter o seguinte:

  • Função Administrador da Organização do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

EnabledEmailAddressTemplates

Necessário

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

O parâmetro EnabledEmailAddressTemplates especifica os endereços de proxy que estão incluídos em uma diretiva de endereço de email e habilitados. Separe vários valores por vírgulas. A parte de domínio de cada endereço de proxy precisa corresponder a um domínio aceito existente.

EnabledPrimarySMTPAddressTemplate

Necessário

System.String

O parâmetro EnabledPrimarySMTPAddressTemplate especifica o endereço de proxy que está habilitado e incluído em uma diretiva de endereço de email. A parte de domínio de cada endereço de proxy precisa corresponder a um domínio aceito existente.

IncludedRecipients

Necessário

System.Nullable

O parâmetro IncludedRecipients filtra os destinatários utilizados para definir a diretiva de endereço de email. O valor AllRecipients pode ser usado somente por ele mesmo. Quando vários valores do parâmetro IncludedRecipients são separados por vírgulas, o operador Booleano OR é aplicado.

Name

Necessário

System.String

O parâmetro Name especifica o nome da diretiva de endereço de email.

RecipientFilter

Necessário

System.String

O parâmetro RecipientFilter especifica um filtro para destinatários a ser incluído na diretiva de endereço de email. Você não poderá usar este parâmetro se usar algum dos seguintes parâmetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • IncludedRecipients

  • ConditionalStateOrProvince

Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -RecipientFilter.

ConditionalCompany

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCompany filtra por empresa. Ele usa vários valores como uma lista delimitada por vírgulas.

ConditionalCustomAttribute1

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute1 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute10

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute10 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute11

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute11 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute12

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute12 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute13

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute13 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute14

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute14 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute15

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute15 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute2

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute2 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute3

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute3 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute4

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute4 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute5

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute5 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute6

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute6 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute7

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute7 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute8

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute8 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute9

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCustomAttribute9 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalDepartment

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalDepartment filtra por departamento. Ele usa vários valores como uma lista delimitada por vírgulas.

ConditionalStateOrProvince

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalStateOrProvince filtra por estado ou província. Ele usa vários valores como uma lista delimitada por vírgulas.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DisabledEmailAddressTemplates

Opcional

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

O parâmetro DisabledEmailAddressTemplates define os endereços de proxy que estão incluídos em uma diretiva de endereço de email e estão desabilitados. Ele usa vários valores como uma lista delimitada por vírgulas.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando.

Priority

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority

O parâmetro Priority torna a prioridade atual mais alta do que a prioridade especificada como um argumento para este parâmetro.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente é fornecido ao parâmetro TemplateInstance, o comando usa a configuração desse objeto para criar uma cópia exata do objeto em um servidor local ou de destino.

UseRusServer

Opcional

System.String

noteObservação:
Esse parâmetro está disponível somente no Exchange 2007 SP2.

O parâmetro UseRusServer instrui o comando para usar o servidor de Caixa de Correio especificado em que o serviço Lista de Endereços está sendo executado para obter e definir atributos de caixa de correio e de usuário do Active Directory.

O serviço Lista de Endereços é um componente no serviço Atendedor do Sistema Exchange. Esse serviço cria e mantém valores de atributos específicos do Exchange no Active Directory. Você pode usar o serviço Lista de Endereços para atualizar objetos de destinatário em um domínio usando informações específicas, como associação da lista de endereços e endereços de email.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

O código a seguir é um exemplo do comando New-EmailAddressPolicy.

New-EmailAddressPolicy -Name "MyPolicy" -IncludedRecipients MailboxUsers -EnabledPrimarySMTPAddressTemplate SMTP:@contoso.com