Командлет 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 <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-AddressList [-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 <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <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 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute10

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute10 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute11

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute11 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute12

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute12 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute13

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute13 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute14

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute14 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute15

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

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute2

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute2 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute3

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute3 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute4

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute4 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute5

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute5 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute6

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute6 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute7

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute7 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute8

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute8 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

ConditionalCustomAttribute9

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ConditionalCustomAttribute9 задает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр 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

Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController.

ForceUpgrade

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

System.Management.Automation.SwitchParameter

Параметр ForceUpgrade запрещает вывод следующего подтверждения: «Чтобы сохранить изменения, внесенные в объект, необходимо обновить объект до текущей версии Exchange. После обновления управление этим объектом с помощью предыдущей версии диспетчера Exchange будет невозможно. Продолжить обновление и сохранить объект?». Это подтверждение выводится при обновлении списка адресов, созданного в Microsoft Exchange Server 2003 или Exchange 2000 Server. Списком адресов Exchange 2003 или Exchange 2000 нельзя управлять с помощью консоли управления Exchange до тех пор, пока версия объекта не будет обновлена, а фильтр получателей не будет изменен с помощью параметра RecipientFilter или IncludedRecipients.

IncludedRecipients

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

System.Nullable

Параметр IncludedRecipients обеспечивает фильтрацию типов получателей, которые используются для построения глобального списка адресов. Допустимые значения параметра IncludedRecipients: AllRecipients, MailboxUsers, Resources, Contacts и MailGroups.

Значение AllRecipients нельзя использовать с другими параметрами. Если несколько значений параметра IncludedRecipients разделены запятыми, применяется логический оператор OR.

Этот параметр необходимо использовать, если используется любой из параметров Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter.

Instance

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

Microsoft.Exchange.Data.Directory.Management.AddressList

Параметр Instance изредка применяется администраторами, использующими командную строку. Он включен в таблицу параметров к сведению разработчиков.

Name

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

System.String

Параметр Name задает новое имя списка адресов. Имя не должно содержать более 64 символов и не должно включать символов возврата каретки и обратной косой черты (\).

RecipientFilter

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

System.String

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

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

  • RecipientContainer

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

UseRusServer

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

System.String

Примечание.
Этот параметр доступен только в Exchange 2007 с пакетом обновления 2 (SP2).

Параметр UseRusServer указывает на необходимость использования определенного сервера почтовых ящиков, на котором выполняется служба списка адресов, для получения и установки атрибутов почтового ящика и пользователя Active Directory.

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Для выполнения командлета Set-AddressList используемой учетной записи необходимо делегировать следующую роль:

  • роль администратора организации Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

При использовании консоли управления Exchange для управления списками адресов, созданными в Exchange Server 2003 или Exchange 2000 Server, выполните указанные ниже действия.

  • Обновите атрибут версии списка адресов, используя параметр ForceUpgrade.

  • Измените фильтр получателей, используя либо параметр RecipientFilter, либо один из следующих параметров фильтра:

    • ConditionalCompany

    • ConditionalDepartment

    • ConditionalStateOrProvince

    • IncludedRecipients

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

Первый пример показывает, как изменить имя существующего списка адресов.

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

Копировать код
Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true

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