Set-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 Set-EmailAddressPolicy para definir os atributos do serviço de diretório do Active Directory para uma diretiva de endereço de email.
Sintaxe
Set-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-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>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-EmailAddressPolicy [-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>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Use o cmdlet Set-EmailAddressPolicy para permitir que os administradores definam os atributos do Active Directory para uma diretiva de endereço de email específica. Porém, o cmdlet Set-EmailAddressPolicy não aplica as alterações à diretiva de endereço de email. Use o cmdlet Update-EmailAddressPolicy após utilizar o cmdlet Set-EmailAddressPolicy para aplicar as alterações.
Para executar o cmdlet Set-EmailAddressPolicy, você deve usar a conta à qual esteja delegada a seguinte função:
- 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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.
Para obter mais informações sobre o cmdlet Update-EmailAddressPolicy, consulte Update-EmailAddressPolicy.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição | ||
|---|---|---|---|---|---|
Identity |
Obrigatório |
Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter |
Use o parâmetro Identity para especificar a GUID, o nome diferenciado ou o nome da diretiva de endereço de email que representa uma diretiva de endereço de email específico. Você também pode incluir o caminho usando o formato Path\EmailAddressPolicy. Você pode omitir o rótulo do parâmetro Identity para que somente o nome da diretiva de endereço de e-mail ou a GUID. |
||
ConditionalCompany |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCompany define a empresa para a diretiva de endereço de email. Ele usa vários valores como uma lista delimitada por vírgulas. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute1 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute1 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute10 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute10 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute11 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute11 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute12 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute12 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute13 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute13 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute14 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute14 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute15 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute15 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute2 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute2 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute3 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute3 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute4 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute4 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute5 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute5 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute6 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute6 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute7 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute7 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute8 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute8 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalCustomAttribute9 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalCustomAttribute9 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalDepartment |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalDepartment define o departamento para a diretiva de endereço de email. Ele usa vários valores como uma lista delimitada por vírgulas. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
ConditionalStateOrProvince |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
O parâmetro ConditionalStateOrProvince define o estado ou província para a diretiva de endereço de email. Ele usa vários valores como uma lista delimitada por vírgulas. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
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 estao incluídos em uma diretiva de endereço de email e estao 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 recupera dados do Active Directory, inclua o parâmetro DomainController no comando. |
||
EnabledEmailAddressTemplates |
Opcional |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
O parâmetro EnabledEmailAddressTemplates define os endereços de proxy que estão incluídos em uma diretiva de endereço de email e estão habilitados. Ele usa vários valores como uma lista delimitada por vírgulas. |
||
EnabledPrimarySMTPAddressTemplate |
Opcional |
System.String |
O parâmetro EnabledPrimarySMTPAddressTemplate especifica os endereços de proxy que estão incluídos em uma diretiva de endereço de email e estão habilitados. Ele usa vários valores como uma lista delimitada por vírgulas. |
||
ForceUpgrade |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro ForceUpgrade suprime a seguinte confirmação: “Para que as alterações feitas no objeto possam ser salvas, o objeto deve ser atualizado para a versão atual do Exchange. Após a atualização, o objeto não pode ser gerenciado por uma versão anterior do Gerenciador do Sistema do Exchange. Deseja continuar a atualizar e salvar o objeto?” Essa confirmação ocorre quando você atualiza uma diretiva de endereço de email que foi criada no Microsoft Exchange Server 2003 ou no Exchange 2000 Server. Você não poderá gerenciar uma diretiva de endereço de email do Exchange 2003 ou do Exchange 2000 usando o Console de Gerenciamento do Exchange enquanto não atualizar a versão do objeto e alterar o filtro de destinatário usando o parâmetro RecipientFilter ou IncludedRecipients. |
||
IncludedRecipients |
Opcional |
System.Nullable |
O parâmetro IncludedRecipients filtra os tipos de destinatários utilizados para criar a lista de endereços global (GAL). Os valores disponíveis para o parâmetro IncludedRecipients são AllRecipients, MailboxUsers, Resources, Contacts e MailGroups. 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. Use este parâmetro caso esteja usando um dos parâmetros Conditional. Você não poderá usar esse parâmetro ao utilizar o parâmetro RecipientFilter. |
||
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicy |
O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando. |
||
Name |
Opcional |
System.String |
O parâmetro Name especifica o novo nome da diretiva de endereço de email. |
||
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. |
||
RecipientFilter |
Opcional |
System.String |
O parâmetro RecipientFilter filtra os destinatários existentes em uma determinada diretiva de endereço de email. O parâmetro RecipientFilter não pode ser usado quando algum dos parâmetros a seguir está especificado:
Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -RecipientFilter. |
||
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 Set-EmailAddressPolicy em que o nome da diretiva de endereço de email está sendo alterado de EMAIL_ADDRESS_POLICY01 para EMAILADDRESSPOLICY02.
Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02