New-OwaVirtualDirectory

  • Статья

 

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

Последнее изменение раздела: 2010-02-25

С помощью командлета New-OWAVirtualDirectory можно создать новый виртуальный каталог Outlook Web Access для существующего веб-узла служб IIS на компьютере, где выполняется Microsoft Exchange Server 2007.

Синтаксис

New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

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

По умолчанию при установке Exchange 2007 на веб-сайте IIS, используемом по умолчанию на локальном сервере с Microsoft Exchange, создаются указанные ниже виртуальные каталоги Outlook Web Access.

  • Owa. Виртуальный каталог Exchange 2007 Outlook Web Access.

  • Exchange.   Традиционный виртуальный каталог Outlook Web Access, доступный пользователям, у которых есть почтовые ящики на серверах с Exchange Server 2003 или Exchange 2000 Server.

  • Public.   Устаревший виртуальный каталог Outlook Web Access, который указывает на общие папки, находящиеся на серверах с Exchange 2003 или Exchange 2000.

  • Exchweb.   Устаревший виртуальный каталог Outlook Web Access, с помощью которого пользователи получают доступ к виртуальным каталогам Outlook Web Access. По умолчанию запросы в виртуальный каталог «exchweb» направляются серверу почтовых ящиков пользователя.

    noteПримечание.
    В целом, командлет New-OWAVirtualDirectory используется в тех случаях, если для решения деловых задач требуется создание дополнительных виртуальных каталогов (например, для размещения), а также при устранении неполадок в работе Outlook Web Access, например при удалении и последующем воссоздании виртуального каталога Outlook Web Access.

Командлет New-OwaVirtualDirectory должен выполняться на сервере Exchange 2007 с установленной ролью клиентского доступа, на котором планируется разместить новый виртуальный каталог. Используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов целевого сервера.

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

Параметры

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

ApplicationRoot

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

System.String

Этот параметр задает путь виртуального каталога в метабазе.

noteПримечание.
Этот параметр еще не реализован.

AppPoolId

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

System.String

Этот параметр указывает IIS-пул приложений, в котором будет выполняться Outlook Web Access. Рекомендуется оставить значение по умолчанию.

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

Этот параметр определяет полное доменное имя контроллера домена, который извлекает данные из службы каталогов Active Directory.

ExternalAuthenticationMethods

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

Microsoft.Exchange.Data.MultiValuedProperty

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

noteПримечание.
Этот параметр еще не реализован, но его можно настроить с помощью командлета Set-OwaVirtualDirectory.

ExternalUrl

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

System.Uri

Этот параметр указывает имя хоста, который будет использоваться для подключения к серверу Exchange через межсетевой экран. Этот параметр также очень важен, если используется SSL-протокол.

noteПримечание.
Этот параметр можно настраивать только для виртуальных каталогов Exchange Server 2007. Виртуальный каталог Exchange Server 2007 по умолчанию — /owa.

InternalUrl

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

System.Uri

Этот параметр указывает имя хоста сервера-хоста Exchange для подключения внутри области действия межсетевого экрана. Этот параметр также очень важен, если используется SSL-протокол.

noteПримечание.
Этот параметр можно настраивать только для виртуальных каталогов Exchange Server 2007. Виртуальный каталог Exchange Server 2007 по умолчанию — /owa.

Name

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

System.String

Этот параметр указывает имя виртуального каталога Outlook Web Access, если этот виртуальный каталог Outlook Web Access находится на сервере с Exchange 2003 или Exchange 2000.

Если этот виртуальный каталог Outlook Web Access находится на сервере Exchange 2007, этот параметр игнорируется.

OWAVersion

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions

Этот параметр указывает, является ли версия виртуального каталога Outlook Web Access Exchange 2007, Exchange 2003 или Exchange 2000.

Path

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

System.String

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

TemplateInstance

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

System.Management.Automation.PSObject

Когда для этого параметра указывается существующий объект, командлет использует его конфигурацию для создания его точной копии на локальном или целевом сервере.

noteПримечание.
Этот параметр еще не реализован.

VirtualDirectoryType

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes

Этот параметр определяет, на какие объекты указывает виртуальный каталог Outlook Web Access — почтовые ящики, общие папки или exchweb. Он является обязательным, если виртуальный каталог Outlook Web Access находится на сервере Exchange 2003 или Exchange 2000.

Если виртуальный каталог Outlook Web Access находится на сервере Exchange 2007, этот параметр игнорируется.

WebSiteName

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

System.String

Этот параметр указывает имя веб-узла служб IIS, на котором создается виртуальный каталог Outlook Web Access.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В приведенных ниже примерах кода на веб-сайте служб IIS, который не является сайтом по умолчанию, на локальном сервере Exchange создаются традиционные виртуальные каталоги Outlook Web Access с именами «exchange», «public» и «exchweb».

New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Mailboxes -Name "exchange" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType PublicFolders -Name "public" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Exchweb -Name "exchweb" -WebSiteName "Contoso.com"