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