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

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

Командлет Set-AddressList используется для изменения существующего списка адресов.

Синтаксис


Set-AddressList -Identity <AddressListIdParameter> [-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>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <None \| MailboxUsers \| Resources \| MailContacts \| MailGroups \| MailUsers \| AllRecipients>] [-Name <String>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-RecipientFilter <String>] [-WhatIf [<SwitchParameter>]]

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

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

Командлет Get-AddressList, передаваемый конвейерным образом в команду Format-List, используется для получения идентификатора GUID, различающегося имени или пути, а также имени существующего списка адресов. Кроме того, можно использовать командлет Get-AddressList для получения определенного существующего списка адресов с его последующей конвейерной передачей командлету Set-AddressList.

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

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

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

Ошибки

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

Исключения

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

Примеры

ПРИМЕР 1

В этом примере изменяется имя существующего списка адресов.

	Скопировать код
Set-AddressList -Identity "All Users\Sales\building4" -Name building9

ПРИМЕР 2

В этом примере показано, как изменить тип и отдел получателей, включаемых в существующий список адресов, определенный идентификатором GUID. Указанный список адресов является списком адресов из Exchange 2003, таким образом, эта команда обновляет также и этот список адресов.

	Скопировать код
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true