New-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 New-GlobalAddressList para criar uma nova GAL (lista de endereços global).

Sintaxe

New-GlobalAddressList -Name <String> [-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>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-GlobalAddressList -Name <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet New-GlobalAddressList cria uma nova GAL. A GAL é criada no contêiner de configuração da Organização do Microsoft Exchange no serviço de diretório Active Directory.

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

Parâmetros

Parâmetro Necessário Tipo Descrição

Name

Necessário

System.String

O parâmetro Name especifica o nome da nova GAL.

ConditionalCompany

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCompany define o atributo de empresa na GAL.

ConditionalCustomAttribute1

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute10

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute11

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute12

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute13

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute14

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute15

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute2

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute3

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute4

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute5

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute6

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute7

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute8

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalCustomAttribute9

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

ConditionalDepartment

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalDepartment define o atributo de empresa na GAL.

ConditionalStateOrProvince

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalStateOrProvince define o atributo na GAL para o estado ou província. Ele usa vários valores como uma lista delimitada por vírgulas.

Confirm

Optional

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.

IncludedRecipients

Opcional

System.Nullable

O parâmetro IncludedRecipients define os destinatários incluídos que estão na GAL.

RecipientFilter

Opcional

System.String

O parâmetro RecipientFilter define os destinatários que estão contidos na GAL. O parâmetro RecipientFilter não poderá ser usado se algum dos seguintes parâmetros for especificado:

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

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

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido ao parâmetro TemplateInstance, o comando usará a configuração desse objeto para criar uma cópia exata do objeto em um servidor local ou de destino.

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

Optional

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 New-GlobalAddressList é usado para criar uma nova GAL chamada NewGAL.

New-GlobalAddressList -Name NewGAL