Set-OfflineAddressBook
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2007-07-05
Используйте командлет Set-OfflineAddressBook, чтобы изменить параметры автономной адресной книги.
Синтаксис
Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]
Set-OfflineAddressBook [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-Instance <OfflineAddressBook>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]
Подробное описание
Командлет Set-OfflineAddressBook используется для изменения параметров существующей автономной адресной книги. Автономная адресная книга очень полезна для тех пользователей, которые довольно много работают автономно. Автономная адресная книга — это снимок одного или нескольких списков адресов, которые клиенты MAPI могут загрузить для обеспечения доступа к спискам адресов при автономной работе.
Создание автономной адресной книги не прекращается, даже если для него необходимо больше времени, чем указано параметром Schedule.
Для выполнения командлета Set-OfflineAddressBook используемой учетной записи необходимо делегировать следующую роль:
- роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter |
С помощью параметра Identity можно задать GUID, различающееся имя или имя автономной адресной книги, которые представляют определенную автономную адресную книгу. Можно также включить путь в формате «сервер\имя_автономной_адресной_книги». Можно опустить метку параметра Identity, оставив только имя автономной адресной книги или GUID. |
AddressLists |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[] |
Параметр AddressLists указывает массив идентификаторов списка адресов, входящих в автономную адресную книгу. |
ApplyMandatoryProperties |
Необязательный |
System.Management.Automation.SwitchParameter |
Создание автономной адресной книги Exchange 2007 с помощью диспетчера Exchange Server 2003 Exchange не поддерживается. Если автономная адресная книга Exchange 2007 создана с помощью этого средства, она будет считаться устаревшей автономной книгой, даже если она находится на сервере Exchange 2007. Чтобы изменить обязательные свойства автономной адресной книги в этом состоянии для исправления проблемы, используйте параметр ApplyMandatoryProperties. |
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется. |
DiffRetentionPeriod |
Необязательный |
System.Nullable |
Параметр DiffRetentionPeriod указывает период времени (в днях), в течение которого файлы отличий автономной адресной книги сохраняются на сервере, создающем автономную адресную книгу, и сервере клиентского доступа. Для хранения файлов отличий автономной адресной книги в течение неопределенного времени используется значение Unlimited (Не ограничен). |
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Для указания полного доменного имени контроллера домена, извлекающего данные из службы каталогов Active Directory, включите в команду параметр DomainController. |
Instance |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.OfflineAddressBook |
Параметр Instance позволяет передать в обрабатываемую команду весь объект. Он обычно используется в сценариях, где целый объект должен быть отправлен команде. |
IsDefault |
Необязательный |
System.Boolean |
Параметр IsDefault устанавливает данную автономную адресную книгу как автономную адресную книгу по умолчанию для всех новых хранилищ почтовых ящиков. |
Name |
Необязательный |
System.String |
ПараметрName устанавливает новое имя автономной адресной книги. Это имя отображается в консоли управления Exchange. Значение параметра Name может включать до 64 символов. |
PublicFolderDistributionEnabled |
Необязательный |
System.Boolean |
Значение $true, установленное для параметра PublicFolderDistributionEnabled, указывает, что автономная адресная книга будет распространяться через общие папки. По умолчанию установлено значение «$true». |
Schedule |
Необязательный |
Microsoft.Exchange.Data.Schedule |
Параметр Schedule указывает интервал, запланированный для создания автономной адресной книги. Параметр Schedule должен содержать интервал в следующем формате: день_недели.час:минута[AM/PM]-день_недели.час:минута[AM/PM]. |
Versions |
Необязательный |
System.Collections.ObjectModel.Collection |
Параметр Versions указывает версии автономной адресной книги, созданные для загрузки клиента. Доступны следующие версии: версия_4, версия_3 и версия_2. Version4 предназначена для клиентов Microsoft Office Outlook 2007 или Office Outlook 2003 с пакетом обновления 2 (SP2). Version3 предназначена для клиентов Outlook, поддерживающих Юникод. Version2 предназначена для клиентов Microsoft Exchange Server 2007, Exchange 2003, Exchange 2000 Server и Exchange Server version 5.5. |
VirtualDirectories |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[] |
Параметр VirtualDirectories указывает массив объектов OABVirtualDirectory (виртуального каталога автономной адресной книги). Если указан параметр VirtualDirectories, должна быть создана версия_4 автономной адресной книги. |
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется. |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
Исключения
| Исключения | Описание |
|---|---|
|
Пример
В этом примере изменяется имя автономной адресной книги.
Set-OfflineAddressBook -Identity "\Default Offline Address Book" -Name "My Offline Address Book"