Командлет Set-AddressList (окончательная первоначальная версия)
Применимо к: Exchange Server 2007
Последнее изменение раздела: 2007-10-23
Командлет Set-AddressList используется для изменения существующего списка адресов.
Синтаксис
Set-AddressList -Identity <AddressListIdParameter> [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]
Set-AddressList [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>]
Подробное описание
Для выполнения командлета Set-AddressList используемой учетной записи необходимо делегировать следующую роль:
- роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
При использовании консоли управления Exchange для управления списками адресов, созданными в Exchange Server 2003 или Exchange 2000 Server, выполните указанные ниже действия.
Обновите атрибут версии списка адресов, используя параметр ForceUpgrade.
Измените фильтр получателей, используя либо параметр RecipientFilter, либо один из следующих параметров фильтра:
ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients
Параметры
| Параметр | Обязательность | Тип | Описание |
|---|---|---|---|
Идентификатор |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter |
С помощью параметра Identity можно задать GUID, различающееся имя или имя списка адресов, которые представляют определенный список адресов. Можно также включить путь в формате «путь\имя_списка_адресов». Можно опустить метку параметра Identity, оставив только имя списка адресов или GUID. |
ConditionalCompany |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCompany является фильтром, определяющим компанию. Все получатели с атрибутом компании, который соответствует значению, введенному для этого параметра, будут включены в изменяемый список адресов. В качестве списка можно использовать несколько значений, разделенных запятыми. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute1 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute1 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute10 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute10 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute11 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute11 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute12 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute12 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute13 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute13 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute14 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute14 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute15 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute15 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute2 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute2 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute3 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute3 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute4 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute4 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute5 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute5 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute6 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute6 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute7 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute7 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute8 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute8 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute9 |
Дополнительно |
System.String |
Параметр ConditionalCustomAttribute9 указывает настраиваемые атрибуты. Настраиваемые атрибуты позволяют добавлять в список адресов дополнительные сведения, по которым можно сортировать или группировать списки адресов. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalDepartment |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalDepartment является фильтром, определяющим отдел. Все получатели с атрибутом отдела, совпадающим со значением, введенным для данного параметра, будут включены в список адресов. В качестве списка можно использовать несколько значений, разделенных запятыми. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalStateOrProvince |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalStateOrProvince является фильтром, определяющим область или край. Все получатели с атрибутом ConditionalStateOrProvince, который соответствует значению, введенному для этого параметра, будут включены в список адресов. В качестве списка можно использовать несколько значений, разделенных запятыми. При использовании параметра Conditional необходимо также использовать параметр IncludedRecipients. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
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 изредка применяется администраторами, использующими командную строку. Он включен в таблицу параметров к сведению разработчиков. |
Имя |
Дополнительно |
System.String |
Параметр Name задает новое имя списка адресов. Имя не должно содержать более 64 знаков и не должно включать знаков возврата каретки и обратной косой черты (\). |
RecipientFilter |
Дополнительно |
System.String |
Параметр RecipientFilter определяет фильтр для получателей, включаемых в список адресов. Этот параметр не допускается использовать, если применяется любой из следующих параметров фильтра:
Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -RecipientFilter. |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Исключения
| Исключения | Описание |
|---|---|
|
|
Пример
Первый пример показывает, как изменить имя существующего списка адресов.
Второй пример показывает, как изменить тип и отдел получателей, включаемых в существующий список адресов с именем 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.