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

New-OfflineAddressBook

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет New-OfflineAddressBook для создания автономных адресных книг (OAB).

В Exchange Online этот командлет доступен только в роли "Списки адресов", которая по умолчанию не назначена ни одной группе ролей. Чтобы использовать этот командлет, добавьте роль "Списки адресов" в группу ролей (например, в группу ролей "Управление организацией"). Подробнее см. в разделе Добавление роли в группу ролей.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

New-OfflineAddressBook
   [-Name] <String>
   -AddressLists <AddressBookBaseIdParameter[]>
   [-Confirm]
   [-DiffRetentionPeriod <Unlimited>]
   [-DomainController <Fqdn>]
   [-GeneratingMailbox <MailboxIdParameter>]
   [-GlobalWebDistributionEnabled <Boolean>]
   [-IsDefault <Boolean>]
   [-PublicFolderDatabase <DatabaseIdParameter>]
   [-PublicFolderDistributionEnabled <Boolean>]
   [-Schedule <Schedule>]
   [-Server <ServerIdParameter>]
   [-ShadowMailboxDistributionEnabled <Boolean>]
   [-SkipPublicFolderInitialization]
   [-Versions <MultiValuedProperty>]
   [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

$a = Get-AddressList | Where {$_.Name -Like "*AgencyB*"}

New-OfflineAddressBook -Name "OAB_AgencyB" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"

В Exchange Server 2010 и 2013 годах в этом примере используются две команды для создания автономной адресной книги с именем OAB_AgencyB, которая включает все списки адресов, частью которых является AgencyB. Используя указанные параметры, автономная адресная адрес создается myserver.contoso.com по понедельникам и средам с 01:00 (1:00) до 02:00 (2 утра). В этом примере команда также создает автономную адресную книгу по умолчанию для организации.

Пример 2

New-OfflineAddressBook -Name "Contoso Executives OAB" -AddressLists "Default Global Address List","Contoso Executives Address List" -GlobalWebDistributionEnabled $true

В этом примере создается новая автономная адресная запись Contoso Executives со следующими свойствами:

  • Списки адресов, включенные в автономную адресную книгу: глобальный список адресов по умолчанию и список адресов руководителей Contoso
  • Все виртуальные каталоги OAB в организации могут принимать запросы на скачивание автономной адресной папки.

Почтовый ящик организации, отвечающий за создание автономной адресной папки, — Это SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} (мы не использовали параметр GeneratingMailbox для указания другого почтового ящика организации).

Автономная адресная адрес не используется почтовыми ящиками и базами данных почтовых ящиков, в которых не указана автономная адресная запись с $true).

Пример 3

New-OfflineAddressBook -Name "New OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -VirtualDirectories "SERVER01\OAB (Default Web Site)"

В Exchange Server 2010 г. в этом примере создается новая автономная адресная адресная адресная запись, которая использует веб-дистрибутив для клиентов Microsoft Office Outlook 2007 или более поздних версий на сервере SERVER01, используя виртуальный каталог по умолчанию.

Пример 4

New-OfflineAddressBook -Name "Legacy OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -PublicFolderDatabase "PFDatabase" -PublicFolderDistributionEnabled $true -Versions Version1,Version2

В Exchange Server 2010 г. в этом примере создается устаревшая автономная адресная папка, использующая дистрибутив общедоступных папок для клиентов Outlook 2003 с пакетом обновления 1 (SP1) и Outlook 98 с пакетом обновления 2 (SP2) на сервере SERVER01.

Если вы настроили OAB для использования распространения общедоступных папок, но в вашей организации нет инфраструктуры общедоступных папок, будет возвращена ошибка. Дополнительные сведения см. в разделе Управление общедоступными папками.

Параметры

-AddressLists

Параметр AddressLists определяет списки адресов (в том числе глобальные), которые входят в автономную адресную книгу. Можно использовать любое уникальное значение, определяющее список адресов. Например:

  • имя;
  • различающееся имя (DN);
  • GUID

Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Значения, идентифицирующие списки адресов (в том числе глобальные), можно найти с помощью командлетов Get-AddressList и Get-GlobalAddressList.

Type:AddressBookBaseIdParameter[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DiffRetentionPeriod

Параметр DiffRetentionPeriod определяет, сколько дней будут храниться на сервере файлы разностного обновления для автономной адресной книги. Допустимые значения — целые числа от 7 до 1825 или значение unlimited. Значение по умолчанию — 30 дней.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GeneratingMailbox

Этот параметр доступен только в локальной среде Exchange.

Параметр GeneratingMailbox определяет почтовый ящик разрешения конфликтов, в котором создается автономная адресная книга. В частности, почтовый ящик арбитража должен содержать значение OrganizationCapabilityOABGen для свойства PersistedCapability. Почтовый ящик разрешения конфликтов с такой функцией известен также как почтовый ящик организации. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

Значение по умолчанию для этого параметра — почтовый ящик организации с именем SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}.

Один почтовый ящик организации может создавать несколько AAB (вы можете использовать одно и то же значение для этого параметра в параметрах нескольких OAB), но в Exchange 2013 CU5 или более поздних версий автономная адресная адрес может быть создана только одним почтовым ящиком организации (этот параметр не принимает несколько значений). Чтобы сделать копию автономной адресной книги, предназначенной только для чтения (ее еще называют теневой копией), доступной в других почтовых ящиках организации, используйте параметр ShadowMailboxDistributionEnabled.

Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GlobalWebDistributionEnabled

Этот параметр доступен только в локальной среде Exchange.

Параметр GlobalWebDistributionEnabled определяет, могут ли все виртуальные каталоги автономных адресных книг в организации принимать запросы на скачивание автономной адресной книги. Эти расположения объявляет служба автообнаружения. Допустимые значения:

  • $true. Любой виртуальный каталог автономной адресной области в организации может принимать запросы на скачивание автономной адресной адресной области. Этот параметр невозможно использовать с параметром VirtualDirectories.
  • $false: только виртуальные каталоги OAB, указанные в параметре VirtualDirectories, принимают запросы на скачивание OAB. Это значение используется по умолчанию.

В Exchange 2013 CU7 или более поздней версии рекомендуется использовать значение $true для этого параметра. Службы клиентского доступа на любом сервере почтовых ящиков могут перенаправлять входящие запросы на скачивание автономных адресных книг в правильное расположение.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsDefault

Параметр IsDefault определяет, будет ли использоваться автономная адресная книга всеми почтовыми ящиками и базами данных почтовых ящиков, для которых не задана автономная адресная книга. Допустимые значения:

  • $true: автономная адресная адрес
  • $false: автономная адресная адресная запись не является автономной адресной адресом по умолчанию. Это значение используется по умолчанию.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

Параметр Name определяет уникальное имя для автономной адресной книги. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PublicFolderDatabase

Этот параметр доступен только в Exchange Server 2010.

Параметр PublicFolderDatabase указывает базу данных общедоступных папок, которая используется для распространения автономной адресной папки. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:

  • имя;
  • различающееся имя (DN);
  • GUID

Чтобы использовать этот параметр, параметру PublicFolderDistributionEnabled необходимо задать значение $true.

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-PublicFolderDistributionEnabled

Этот параметр доступен только в Exchange Server 2010.

Параметр PublicFolderDistributionEnabled указывает, распространяется ли автономная адресная папка через общедоступные папки. Если значение параметра PublicFolderDistributionEnabled равно $true, автономная адресная папка распространяется через общедоступные папки.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Schedule

Этот параметр доступен только в Exchange Server 2010.

Параметр Schedule задает интервал для создания автономной адресной записи в Exchange 2010 или более ранней версии.

Синтаксис этого параметра: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM].

Для дней можно использовать следующие значения:

  • Полное название дня.
  • Сокращенное название дня.
  • Целое число от 0 до 6, где 0 = воскресенье.

Вы можете ввести время в формате 24 часа и опустить значение AM/PM. Если ввести время в формате 12 часов, укажите пробел между временем и значением AM/PM.

Вы можете сочетать и сопоставлять форматы даты и времени.

Промежуток между временем начала и временем окончания должен составлять не менее 15 минут. Число минут округляется до значений 0, 15, 30 и 45.

Ниже приводятся примеры:

  • "Sun.11:30 PM-Mon.1:30 AM"
  • "6.22:00-6.22:15" (Работает с субботы в 22:00 по субботу в 22:15.
  • "Вс.1:15-понедельник.23:00"
Type:Schedule
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Server

Этот параметр доступен только в Exchange Server 2010.

Параметр Server задает сервер Exchange, на котором следует выполнить эту команду. Можно использовать любое значение, однозначно определяющее сервер. Примеры:

  • Имя.
  • полное доменное имя;
  • различающееся имя (DN);
  • ExchangeLegacyDN

Устаревшее различающееся имя Exchange

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ShadowMailboxDistributionEnabled

Этот параметр доступен только в локальной среде Exchange.

Параметр ShadowMailboxDistributionEnabled указывает, распространяется ли копия OAB только для чтения (также известная как теневая копия) во все другие почтовые ящики создания OAB (также известные как почтовые ящики организации). Это позволяет дополнительным серверам почтовых ящиков быть конечными точками для запросов на скачивание автономной адресной папки, что может помочь предотвратить загрузку автономной адресной почты через медленные каналы глобальной сети. Допустимые значения:

  • $true. Автономная адресная адрес распространяется на все почтовые ящики организации.
  • $false. Автономная адресная адрес не распространяется на почтовые ящики других организаций. Это значение используется по умолчанию.

Значение этого параметра имеет смысл только при наличии нескольких почтовых ящиков организации и полезно только в организациях Exchange с несколькими сайтами Active Directory.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SkipPublicFolderInitialization

Этот параметр доступен только в Exchange Server 2010.

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Versions

Этот параметр доступен только в Exchange Server 2010.

Параметр Versions определяет версии автономной адресной книги, сформированные для скачивания клиентом. Допустимые значения:

  • Версия 2 (требуется распространение общедоступных папок)
  • Версия 3 (требуется распространение общедоступных папок)
  • Version4 (значение по умолчанию)
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-VirtualDirectories

Этот параметр доступен только в локальной среде Exchange.

Параметр VirtualDirectories указывает виртуальные каталоги OAB, которые принимают запросы на скачивание автономной адресной адресной записи. Эти расположения объявляет служба автообнаружения.

Можно использовать любое уникальное значение, идентифицирующее виртуальный каталог. Например:

  • Имя или Сервер\Имя
  • различающееся имя (DN);
  • GUID

Значение Name использует синтаксис "VirtualDirectoryName (WebsiteName)" из свойств виртуального каталога. Вместо веб-сайта по умолчанию можно указать подстановочный знак (*) с помощью синтаксиса VirtualDirectoryName*.

Значение по умолчанию этого параметра — виртуальные каталоги служб клиентского доступа (внешний интерфейс) и серверной автономной адресной адресной записи на сервере почтовых ящиков, на котором хранится почтовый ящик создания OAB (параметр GeneratingMailbox или SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}). Например, Mailbox01\OAB (веб-сайт по умолчанию),Mailbox01\OAB (серверная часть Exchange).

Чтобы можно было использовать этот параметр, значение для параметра GlobalWebDistributionEnabled должно быть $false.

В Exchange 2013 CU7 или более поздних версий рекомендуется задать для параметра GlobalWebDistributionEnabled значение $true, так как службы клиентского доступа на любом сервере почтовых ящиков могут выполнять прокси-запросы на скачивание входящие OAB в правильном расположении.

Type:VirtualDirectoryIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.