Compartilhar via

New-AddressList (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

Use o cmdlet New-AddressList para criar uma nova lista de endereços e aplicá-la a destinatários.

Sintaxe

New-AddressList -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>] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>]

New-AddressList -Name <String> [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>]

Descrição detalhada

Para executar o cmdlet New-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.

Parâmetros

Parâmetro Necessário Tipo Descrição

Name

Necessário

System.String

O parâmetro Name especifica o nome desejado para a nova 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 (\).

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. Você pode usar vários valores como uma lista delimitada por vírgulas. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter. Você deve usar o parâmetro RecipientFilter ou um destes parâmetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

ConditionalCustomAttribute1

Opcional

System.String

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

ConditionalCustomAttribute10

Opcional

System.String

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

ConditionalCustomAttribute11

Opcional

System.String

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

ConditionalCustomAttribute12

Opcional

System.String

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

ConditionalCustomAttribute13

Opcional

System.String

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

ConditionalCustomAttribute14

Opcional

System.String

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

ConditionalCustomAttribute15

Opcional

System.String

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

ConditionalCustomAttribute2

Opcional

System.String

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

ConditionalCustomAttribute3

Opcional

System.String

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

ConditionalCustomAttribute4

Opcional

System.String

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

ConditionalCustomAttribute5

Opcional

System.String

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

ConditionalCustomAttribute6

Opcional

System.String

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

ConditionalCustomAttribute7

Opcional

System.String

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

ConditionalCustomAttribute8

Opcional

System.String

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

ConditionalCustomAttribute9

Opcional

System.String

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

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ê não poderá usar este parâmetro se usar o parâmetro RecipientFilter. Você deve usar o parâmetro RecipientFilter ou um destes parâmetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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ê não poderá usar este parâmetro se usar o parâmetro RecipientFilter. Você deve usar o parâmetro RecipientFilter ou um destes parâmetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Container

Opcional

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

O parâmetro Container especifica a identidade da lista de endereços pai em que a nova lista de endereços será criada. Se nenhuma lista de endereços pai for especificada, a lista de endereços será criada na raiz de "Todas as Listas de Endereços".

DisplayName

Opcional

System.String

O parâmetro DisplayName especifica o nome de exibição desejado da lista de endereços. Se nenhum nome para exibição for fornecido, o nome da lista de endereços também será o nome para exibição.

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 é um filtro para especificar o tipo de destinatário a ser incluído na lista de endereços. Você pode usar um ou mais dos seguintes tipos:

  • Nenhum

  • UserMail

  • Recursos

  • MailGroups

  • MailContacts

  • AllRecipients

Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter. Você deve usar o parâmetro RecipientFilter ou um destes parâmetros de filtro:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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

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

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 para o 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

O primeiro exemplo mostra como criar uma nova lista de endereços chamada MyAddressList. A lista de endereços inclui destinatários que são usuários da caixa de correio e têm StateOrProvince definido como Washington ou Oregon.

O segundo exemplo mostra como criar uma nova lista de endereços denominada MyAddressList2 que inclui caixas de correio cujo parâmetro ConditionalStateOrProvince está definido como Washington.

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers