Командлет New-OfflineAddressBook (окончательная первоначальная версия)
Применимо к: Exchange Server 2007
Последнее изменение раздела: 2007-06-05
С помощью командлета New-OfflineAddressBook можно создавать автономные адресные книги (OAB).
Синтаксис
New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
Подробное описание
Командлет New-OfflineAddressBook позволяет администраторам создавать новые автономные адресные книги. Например, если нужно удалить сервер клиентского доступа, который содержит автономную адресную книгу, потребуется воссоздать эту книгу на другом сервере клиентского доступа.
Для выполнения командлета New-OfflineAddressBook используемой учетной записи необходимо делегировать следующие роли:
- роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
Параметр | Обязательность | Тип | Описание |
---|---|---|---|
AddressLists |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[] |
Параметр AddressLists указывает массив идентификаторов списка адресов, включенных в автономную адресную книгу. |
Имя |
Обязательность |
System.String |
Параметр Name указывает имя, которое описывает объект автономной адресной книги в диспетчере Exchange (до 64 символов). |
Server (сервер) |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Параметр Server указывает сервер, на котором будет создана новая автономная адресная книга. |
DiffRetentionPeriod |
Дополнительно |
System.Nullable |
Параметр DiffRetentionPeriod указывает период времени (в днях), в течение которого файлы различий автономных адресных книг хранятся на сервере автономной адресной книги и сервере клиентского доступа. Чтобы хранить файлы различий автономных адресных книг в течение неограниченного периода времени, используйте значение «Unlimited». |
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Параметр DomainController указывает контроллер домена, который будет использован для создания автономной адресной книги. |
IsDefault |
Дополнительно |
System.Boolean |
Если параметр IsDefault имеет значение «$true», автономная адресная книга назначается используемой по умолчанию для всех создаваемых баз данных почтовых ящиков. Если этот параметр имеет значение «$false», данная адресная книга не будет использоваться по умолчанию. |
PublicFolderDatabase |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Параметр PublicFolderDatabase указывает идентификатор базы данных общих папок. |
PublicFolderDistributionEnabled |
Дополнительно |
System.Boolean |
Если параметр PublicFolderDistributionEnabled имеет значение |
Расписание |
Дополнительно |
Microsoft.Exchange.Data.Schedule |
Параметр Schedule указывает интервал, на который запланировано создание новой автономной адресной книги. Параметр расписания Schedule имеет следующий формат и должен содержать интервал: День_недели.Час:Минута[AM/PM]-День_недели.Час:Минута[AM/PM]. |
TemplateInstance |
Дополнительно |
System.Management.Automation.PSObject |
Параметр TemplateInstance указывает шаблон, который будет использоваться для создания новой автономной адресной книги. |
Versions |
Дополнительно |
System.Collections.ObjectModel.Collection |
Параметр Versions указывает версию создаваемой автономной адресной книги. Возможные значения:
|
VirtualDirectories |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[] |
Параметр VirtualDirectories задает массив объектов OABVirtualDirectory. Если указан параметр VirtualDirectories, автономная адресная книга должна создаваться с версией Version4. |
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
|
Пример
В этом примере с помощью двух команд создается новая автономная адресная книга с именем «OfflineAddressBook», которая содержит все доступные списки адресов в организации. При указанных параметрах автономная адресная книга будет создаваться на сервере myserver.contoso.com по понедельникам и средам с 01:00 до 02:00. При выполнении этой команды также создается автономная адресная книга, которая будет использоваться в организации по умолчанию.
$a = Get-AddressList
New-OfflineAddressBook -Name "OfflineAddressBook" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"