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