Compartilhar via


Set-GlobalAddressList

 

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-GlobalAddressList para modificar os atributos do serviço de diretório Active Directory para uma GAL (lista de endereços global).

Sintaxe

Set-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-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>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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

Descrição detalhada

O cmdlet Set-GlobalAddressList modifica as propriedades em uma GAL.

Para executar o cmdlet Set-GlobalAddressList, 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 Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter

Use o parâmetro Identity para especificar a GUID, o nome distinto ou o nome da GAL (lista de endereços global) que representa uma GAL específica. Você também pode incluir o caminho usando o formato Path\GlobalAddressListName.

Você pode omitir o rótulo do parâmetro Identity para que somente o nome da GAL ou a GUID seja fornecido.

ConditionalCompany

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCompany é usado para especificar uma empresa. Você pode usar 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute1

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute10

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute11

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute12

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute13

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute14

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute15

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute2

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute3

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute4

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute5

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute6

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute7

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute8

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute9

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalDepartment

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalDepartment é usado para especificar um departamento. Todas as GALs com um atributo de departamento correspondente ao valor da entrada deste parâmetro serão incluídas. Você pode usar 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 este parâmetro se usar o parâmetro RecipientFilter.

ConditionalStateOrProvince

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalStateOrProvince define o estado ou bairro para a lista de endereço global. 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 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.

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.

ForceUpgrade

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ForceUpgrade suprime a seguinte confirmação: “Para salvar as alterações feitas no objeto, ele 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 voce atualiza uma GAL criada no Microsoft Exchange Server 2003 ou no Exchange 2000 Server. Voce não pode gerenciar uma GAL do Exchange 2003 ou do Exchange 2000 usando o Console de Gerenciamento do Exchange antes de atualizar a versão do objeto e alterar o filtro de destinatário com o parâmetro RecipientFilter ou IncludedRecipients.

IncludedRecipients

Opcional

System.Nullable

O parâmetro IncludedRecipients filtra os tipos de destinatários usados para criar a 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.GlobalAddressList

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 lista de endereços global.

RecipientFilter

Opcional

System.String

O parâmetro RecipientFilter especifica um filtro para destinatários a ser incluído na GAL. Você não poderá usar esse parâmetro se usar algum dos seguintes parâmetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • IncludedRecipients

  • ConditionalStateorProvince

Você deve usar esse parâmetro ou um dos parâmetros de filtro listados anteriormente.

Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -RecipientFilter.

UseRusServer

Optional

System.String

noteObservação:
Esse parâmetro está disponível somente no Exchange 2007 SP2.

O parâmetro UseRusServer instrui o comando a usar o servidor Caixa de Correio especificado no qual 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 do serviço Atendedor do Sistema do Exchange. O serviço Lista de Endereços cria e mantém valores de atributo específicos do Exchange no Active Directory. O serviço Lista de Endereços pode ser usado para atualizar objetos de destinatário em um domínio usando informações específicas, como a 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á 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.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

Neste exemplo, o comando Set-GlobalAddressList é usado para atribuir um novo nome, GALwithNewName, à GAL com a GUID 96d0c505-eba8-4103-ad4f-577a1bf4ad7b.

Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName