Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-24

С помощью командлета New-GlobalAddressList можно создать новый глобальный список адресов (global address list, GAL).

Синтаксис

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 <None | MailboxUsers | Resources | MailContacts | MailGroups | MailUsers | AllRecipients>] [-Organization <OrganizationIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-WhatIf [<SwitchParameter>]]
New-GlobalAddressList -Name <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-RecipientFilter <String>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр Обязательный Тип Описание

Name

Обязательный

System.String

Параметр Name указывает имя нового глобального списка адресов.

ConditionalCompany

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCompany указывает атрибут компании в этом глобальном списке адресов.

ConditionalCustomAttribute1

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute10

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute11

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute12

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute13

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute14

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute15

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute2

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute3

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute4

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute5

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute6

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute7

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute8

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalCustomAttribute9

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметры от ConditionalCustomAttribute1 до ConditionalCustomAttribute15 задают фильтры для настраиваемых атрибутов получателей. Например, если для параметра ConditionalCustomAttribute1 установлено значение Marketing, то фильтр включает в себя всех получателей, в параметре CustomAttribute1 которых установлено значение Marketing. Параметр IncludedRecipients необходимо использовать совместно с параметром Conditional. Этот параметр не может применяться совместно с параметром RecipientFilter.

ConditionalDepartment

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalDepartment указывает атрибут отдела в глобальном списке адресов.

ConditionalStateOrProvince

Необязательный

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalStateOrProvince указывает атрибут края или региона в глобальном списке адресов. Можно использовать несколько значений в виде списка, разделенного запятыми.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.

IncludedRecipients

Необязательный

Microsoft.Exchange.Data.Directory.Recipient.WellKnownRecipientType

Параметр IncludedRecipients задает получателей, включенных в глобальный список адресов.

Organization

Необязательный

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support.

Параметр Organization указывает организацию, в которой будет выполняться это действие. Этот параметр не допускает ввода подстановочных знаков, поэтому необходимо использовать точное название организации.

RecipientContainer

Необязательный

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр RecipientContainer позволяет применить фильтр к получателям, которые используются для создания динамической группы рассылки, на основе их расположения в Служба каталогов Active Directory. В качестве значения параметра RecipientContainer может использоваться каноническое имя подразделения или домена. Если значение параметра RecipientContainer не указано, то по умолчанию для фильтра поиска используется расположение динамической группы рассылки в Служба каталогов Active Directory.

RecipientFilter

Необязательный

System.String

Параметр RecipientFilter указывает получателей, содержащихся в глобальном списке адресов. Параметр RecipientFilter нельзя использовать, если указаны какие-либо из следующих параметров:

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -RecipientFilter.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно.

Подробное описание

Глобальный список адресов создается в контейнере конфигурации организации Microsoft Exchange в службе каталогов Служба каталогов Active Directory.

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Глобальные списки адресов» в разделе Разрешения для почтового ящика.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

Исключения

Исключения Описание

Примеры

ПРИМЕР 1

В этом примере создается глобальный список адресов NewGAL.

Скопировать код
New-GlobalAddressList -Name NewGAL