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

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

Командлет Set-GlobalAddressList используется для изменения атрибутов глобального списка адресов в службе Служба каталогов Active Directory.

Синтаксис


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 <None \| MailboxUsers \| Resources \| MailContacts \| MailGroups \| MailUsers \| AllRecipients>] [-Name <String>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-RecipientFilter <String>] [-WhatIf [<SwitchParameter>]]

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 <None |
MailboxUsers | Resources | MailContacts | MailGroups | MailUsers |
AllRecipients>] [-Name <String>] [-RecipientContainer
<OrganizationalUnitIdParameter>] [-RecipientFilter
<String>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр	Обязательный	Тип	Описание
Identity	Обязательный	Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter	Параметр Identity указывает идентификатор GUID, различающееся имя или имя глобального списка адресов, которые представляют определенный глобальный список адресов. Можно также включить путь в формате путь\имя_глобального_списка_адресов. Можно опустить метку параметра, чтобы было указано только имя GAL или идентификатор GUID.
ConditionalCompany	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметр ConditionalCompany указывает компанию. Можно использовать несколько значений в виде списка, разделенного запятыми. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр невозможно применять, если используется параметр RecipientFilter.
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 указывает отдел. Будут включены все глобальные списки адресов с атрибутом отдела, имеющим введенное для этого параметра значение. Можно использовать несколько значений в виде списка, разделенного запятыми. При использовании параметра Conditional необходимо также использовать параметрIncludedRecipients. Этот параметр невозможно применять, если используется параметр RecipientFilter.
ConditionalStateOrProvince	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Параметр ConditionalStateOrProvince указывает край или регион в глобальном списке адресов. Для этого параметра можно использовать несколько значений в виде списка, разделенного запятыми. При использовании параметра Conditional необходимо также использовать параметрIncludedRecipients. Этот параметр невозможно применять, если используется параметр RecipientFilter.
Confirm	Необязательный	System.Management.Automation.SwitchParameter	Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn	Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.
ForceUpgrade	Необязательный	System.Management.Automation.SwitchParameter	Параметр ForceUpgrade запрещает вывод следующего подтверждения: «Чтобы сохранить изменения, внесенные в объект, необходимо обновить объект до текущей версии Exchange. После обновления управление этим объектом с помощью предыдущей версии диспетчера Exchange будет невозможно. Продолжить обновление и сохранить объект?». Это подтверждение выводится при обновлении глобального списка адресов, созданного на сервере Microsoft Exchange 2000 Server. Глобальным списком адресов Exchange Server 2003 нельзя управлять с помощью консоли управления Exchange, если версия объекта не будет обновлена, а фильтр получателей не будет изменен с помощью параметра RecipientFilter или IncludedRecipients.
IncludedRecipients	Необязательный	Microsoft.Exchange.Data.Directory.Recipient.WellKnownRecipientType	Параметр IncludedRecipients позволяет отфильтровать типы получателей, которые используются для создания глобального списка адресов. Допустимые значения параметра IncludedRecipients: `None`, `AllRecipients`, `MailboxUsers`, `MailUsers`, `Resources`, `MailContacts` и `MailGroups`. Значение `AllRecipients` может использоваться только самим параметром. Если параметр IncludedRecipients имеет несколько значений, разделенных запятыми, применяется логический оператор OR. Этот параметр необходимо использовать, если используется любой из параметров Conditional. Этот параметр невозможно применять, если используется параметр RecipientFilter.
Name	Необязательный	System.String	Параметр Name указывает новое имя глобального списка адресов.
RecipientContainer	Необязательный	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Параметр RecipientContainer позволяет применить фильтр к получателям, которые используются для создания динамической группы рассылки, на основе их расположения в Служба каталогов Active Directory. В качестве значения параметра RecipientContainer может использоваться каноническое имя подразделения (OU) или домена. Если значение параметра RecipientContainer не указано, по умолчанию для фильтра поиска используется расположение динамической группы рассылки в Служба каталогов Active Directory.
RecipientFilter	Необязательный	System.String	Параметр RecipientFilter указывает фильтр для получателей, которых следует включить в глобальный список адресов. Этот параметр нельзя использовать с любым из следующих параметров: ConditionalCompany ConditionalDepartment IncludedRecipients ConditionalStateorProvince Следует использовать или этот параметр, или один из приведенных выше параметров фильтра. Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -RecipientFilter.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно.

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

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

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

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

Ошибки

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

Исключения

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

Примеры

ПРИМЕР 1

В этом примере глобальному списку адресов с идентификатором GUID 96d0c505-eba8-4103-ad4f-577a1bf4ad7b назначается новое имя «GALwithNewName».

	Скопировать код
Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName