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:
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 |
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. |
.gif "note")
Observação: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