Поделиться через


Командлет 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 имеет значение $true, данная автономная адресная книга будет распространяться через общие папки.

Расписание

Дополнительно

Microsoft.Exchange.Data.Schedule

Параметр Schedule указывает интервал, на который запланировано создание новой автономной адресной книги.

Параметр расписания Schedule имеет следующий формат и должен содержать интервал: День_недели.Час:Минута[AM/PM]-День_недели.Час:Минута[AM/PM].

TemplateInstance

Дополнительно

System.Management.Automation.PSObject

Параметр TemplateInstance указывает шаблон, который будет использоваться для создания новой автономной адресной книги.

Versions

Дополнительно

System.Collections.ObjectModel.Collection

Параметр Versions указывает версию создаваемой автономной адресной книги. Возможные значения:

  • Version1

  • Version2

  • Version3

  • Version4

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"