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

New-OfflineAddressBook

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2008-01-21

С помощью командлета New-OfflineAddressBook можно создавать автономные адресные книги (OAB).

Синтаксис

New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-SkipPublicFolderInitialization <SwitchParameter>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

Подробное описание

Командлет New-OfflineAddressBook позволяет администраторам создавать новые автономные адресные книги. Например, если нужно удалить сервер клиентского доступа, который содержит автономную адресную книгу, потребуется воссоздать эту книгу на другом сервере клиентского доступа.

Для выполнения командлета New-OfflineAddressBook используемой учетной записи необходимо делегировать следующие роли:

  • роль администратора организации Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательный Тип Описание

AddressLists

Обязательный

Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[]

Параметр AddressLists указывает массив идентификаторов списка адресов, включенных в автономную адресную книгу.

Name

Обязательный

System.String

Параметр Name указывает имя, которое описывает объект автономной адресной книги в диспетчере Exchange (до 64 символов).

Server

Обязательный

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server указывает сервер, на котором будет создана новая автономная адресная книга.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется.

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

Schedule

Необязательный

Microsoft.Exchange.Data.Schedule

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

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

SkipPublicFolderInitialization

Необязательный

System.Management.Automation.SwitchParameter

Если создается автономная адресная книга, использующая распространение через общие папки, укажите с помощью параметра SkipPublicFolderInitialization, что необходимо пропускать немедленное создание общих папок автономной адресной книги. Автономная адресная книга не будет доступна для загрузки до завершения следующего цикла обслуживания папки узла. Указывать значение параметра SkipPublicFolderInitialization не требуется. Если опустить данный параметр, это может привести к приостановлению задачи, пока она связывается с соответствующим сервером общих папок для создания необходимых общих папок. Если сервер недоступен или с ним невозможно связаться по другим причинам, пауза может оказаться значительной.

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.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

Исключения

Исключения Описание

 

Пример

В этом примере с помощью двух команд создается новая автономная адресная книга с именем «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"