Командлет Set-GlobalAddressList (окончательная первоначальная версия)
Применимо к: Exchange Server 2007
Последнее изменение раздела: 2007-06-05
С помощью командлета Set-GlobalAddressList можно изменить атрибуты службы каталогов Active Directory для глобального списка адресов.
Синтаксис
Set-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-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>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]
Set-GlobalAddressList [-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>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <GlobalAddressList>] [-Name <String>] [-RecipientFilter <String>]
Подробное описание
Командлет Set-GlobalAddressList исзменяет свойства глобального списка адресов.
Для выполнения командлета Set-GlobalAddressList используемой учетной записи необходимо делегировать следующую роль:
- роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательность | Тип | Описание |
|---|---|---|---|
Идентификатор |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter |
С помощью параметра Identity можно задать GUID, различающееся имя или имя глобального списка адресов, которые представляют определенный глобальный список адресов. Можно также включить путь в формате «путь\имя_глобального_списка_адресов». Можно опустить метку параметра Identity, оставив только имя глобального списка адресов или GUID. |
ConditionalCompany |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalCompany указывает компанию. В качестве списка можно использовать несколько значений, разделенных запятыми. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute1 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute10 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute11 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute12 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute13 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute14 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute15 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute2 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. |
ConditionalCustomAttribute3 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute4 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute5 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute6 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute7 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute8 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalCustomAttribute9 |
Дополнительно |
System.String |
Этот параметр определяет настраиваемые атрибуты. Эти атрибуты можно использовать для хранения дополнительных сведений. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
ConditionalDepartment |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ConditionalDepartment указывает отдел. Будут включены все глобальные списки адресов с атрибутом подразделения, имеющим введенное для этого параметра значение. В качестве списка можно использовать несколько значений, разделенных запятыми. Параметр IncludedRecipients необходимо использовать при применении параметра Conditional. Этот параметр нельзя использовать, если используется параметр RecipientFilter. |
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.GlobalAddressList |
Параметр Instance позволяет передавать весь объект в команду для обработки. Главным образом он используется в сценариях, в которых в команду должен быть передан весь объект. |
Имя |
Дополнительно |
System.String |
Отсутствует. |
RecipientFilter |
Дополнительно |
System.String |
Параметр RecipientFilter указывает фильтр для получателей, которые следует включить в глобальный список адресов. Этот параметр нельзя использовать с любым из следующих параметров:
Следует использовать или этот параметр, или один из приведенных выше параметров фильтра. Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -RecipientFilter. |
ConditionalStateOrProvince |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Отсутствует. |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
Исключения
| Исключения | Описание |
|---|---|
|
Пример
В этом примере командлет Set-GlobalAddressList используется для того, чтобы присвоить новое имя «GALwithNewName» глобальному списку адресов с идентификатором GUID 96d0c505-eba8-4103-ad4f-577a1bf4ad7b.
Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName