Set-AddressList

 

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-AddressList para modificar uma lista de endereços existente.

Sintaxe

Set-AddressList -Identity <AddressListIdParameter> [-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>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-AddressList [-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>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Set-AddressList, você deve usar uma conta à qual esteja delegado 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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Se desejar usar o Console de Gerenciamento do Exchange para gerenciar listas de endereços criadas no Exchange Server 2003 ou Exchange 2000 Server, você deverá fazer o seguinte:

• Atualize o atributo de versão da lista de endereços com o parâmetro ForceUpgrade.

• Altere o filtro do destinatário com o parâmetro RecipientFilter ou um dos seguintes parâmetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
Identity	Necessário	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Utilize o parâmetro Identity para especificar a GUID, o nome distinto ou o nome da lista de endereços que representa uma lista específica de endereços. Você também pode incluir o caminho utilizando o formato Path\AddressListName. Você pode omitir o rótulo do parâmetro Identity para que somente o nome da lista de endereços ou a GUID seja fornecido.
ConditionalCompany	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCompany é um filtro para especificar uma empresa. Todos os destinatários com um atributo de empresa correspondente ao valor da entrada desse parâmetro serão incluídos na lista de endereços que você está modificando. Você pode usar vários valores como uma lista delimitada por vírgulas. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute1	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute1 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute10	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute10 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute11	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute11 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute12	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute12 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute13	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute13 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute14	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute14 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute15	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute15 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute2	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute2 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute3	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute3 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute4	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute4 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute5	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute5 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute6	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute6 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute7	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute7 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute8	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute8 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalCustomAttribute9	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalCustomAttribute9 especifica atributos personalizados. Atributos personalizados permitem adicionar mais informações à lista de endereços, pelas quais você pode classificar ou agrupar listas de endereços. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalDepartment	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalDepartment é um filtro para especificar um departamento. Todos os destinatários com um atributo de departamento correspondente ao valor da entrada deste parâmetro serão incluídos na lista de endereços. Você pode usar vários valores como uma lista delimitada por vírgulas. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.
ConditionalStateOrProvince	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	O parâmetro ConditionalStateOrProvince é um filtro para especificar um estado. Todos os destinatários com um atributo ConditionalStateOrProvince correspondente ao valor da entrada desse parâmetro serão incluídos na lista de endereços. Você pode usar vários valores como uma lista delimitada por vírgulas. Você deve utilizar o parâmetro IncludedRecipients se você utiliza um parâmetro Condicional. Você não poderá usar este parâmetro se usar 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.
DisplayName	Opcional	System.String	O parâmetro DisplayName especifica o nome de exibição desejado da lista de endereços.
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 serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.
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 lista de endereços que foi criada no Microsoft Exchange Server 2003 ou Exchange 2000 Server. Você não pode gerenciar uma lista de endereços do Exchange 2003 ou do Exchange 2000 usando o Console de Gerenciamento do Exchange até que tenha atualizado a versão do objeto e alterado o filtro de destinatário usando os parâmetros 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 este parâmetro se usar o parâmetro RecipientFilter.
Instance	Opcional	Microsoft.Exchange.Data.Directory.Management.AddressList	O parâmetro Instance é raramente usado por administradores que usam a linha de comando. Ele é incluído na tabela de parâmetros para referência do desenvolvedor.
Name	Opcional	System.String	O parâmetro Name especifica um novo nome para a lista de endereços. O nome não pode exceder 64 caracteres e não pode incluir um retorno de carro ou uma barra invertida (\).
RecipientFilter	Opcional	System.String	O parâmetro RecipientFilter especifica um filtro para destinatários a serem incluídos na lista de endereços. Você não poderá usar este parâmetro se usar algum dos seguintes parâmetros de filtro: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients RecipientContainer Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -RecipientFilter.
UseRusServer	Opcional	System.String	Observação: Esse parâmetro está disponível somente no Exchange 2007 SP2. O parâmetro UseRusServer instrui o comando a utilizar o servidor de Caixa de Correio especificado no serviço Lista de Endereços em execução, a fim de obter e então definir a caixa de correio e os atributos de usuário Active Directory. O serviço Lista de Endereços é um componente do serviço Assistente do Sistema Exchange. O serviço Lista de Endereços cria e mantém valores de atributo 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 na 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á visualizar 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 primeiro exemplo mostra como modificar o nome de uma lista de endereços existente.

O segundo exemplo mostra como modificar o tipo de destinatários e o departamento dos destinatários que serão incluídos na lista de endereços existentes chamada MyAddressList2. MyAddressList2 é uma lista de endereços do Exchange 2003, portanto esse comando também atualiza essa lista de endereços.

Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true

Use o comando Get-AddressList, canalizado para Format-List, para obter a GUID, um nome distinto ou o caminho e o nome de uma lista de endereços existente. Ou use Get-AddressList para obter uma lista de endereços existente específica e canalizar a saída diretamente para Set-AddressList.