New-GlobalAddressList (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-05
Use o cmdlet New-GlobalAddressList para criar uma nova GAL (lista de endereços global).
Sintaxe
New-GlobalAddressList -Name <String> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>]
New-GlobalAddressList -Name <String> [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>]
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 |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute10 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute11 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute12 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute13 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute14 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute15 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute2 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute3 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute4 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute5 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute6 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute7 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute8 |
Opcional |
System.String |
Esse parâmetro especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute9 |
Opcional |
System.String |
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. |
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:
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. |
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