New-EmailAddressPolicy (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-05
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 <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>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-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>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
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:
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 |
System.String |
O parâmetro ConditionalCustomAttribute1 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute10 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute10 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute11 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute11 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute12 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute12 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute13 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute13 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute14 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute14 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute15 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute15 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute2 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute2 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute3 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute3 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute4 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute4 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute5 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute5 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute6 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute6 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute7 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute7 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute8 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute8 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute9 |
Opcional |
System.String |
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. |
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. |
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