New-UMVirtualDirectory

  • Статья

 

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

Последнее изменение раздела: 2007-06-28

Командлет New-UMVirtualDirectory используется для создания нового виртуального каталога на компьютере, на котором запущен сервер Microsoft Exchange Server 2007 с установленной ролью клиентского доступа.

Синтаксис

New-UMVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

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

Командлет New-UMVirtualDirectory используется для создания нового виртуального каталога единой системы обмена сообщениями на сервере клиентского доступа Exchange 2007. Можно создать один или несколько виртуальных каталогов единой системы обмена сообщениями.

Для выполнения командлета New-UMVirtualDirectory используемой учетной записи необходимо делегировать роль администратора сервера Exchange 2007 и членство в локальной группе администраторов на целевом сервере.

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

Параметры

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

ApplicationRoot

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

System.String

Этот параметр указывает путь к веб-узлу, определенный в метабазе служб IIS (Internet Information Service). По умолчанию установлен путь /W3SVC/1/ROOT, где 1 — веб-узел по умолчанию.

AppPoolId

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

System.String

Этот параметр указывает имя пула приложений IIS. Данный параметр можно настроить в папке <SERVERNAME>\Application Pools на веб-узле в диспетчере службы IIS. По умолчанию имени пула присвоено значение MSExchangeUMAppPool.

BasicAuthentication

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

System.Boolean

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

DigestAuthentication

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

System.Boolean

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

Confirm

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

System.Management.Automation.SwitchParameter

Этот параметр используется для приостановки команды и требует, чтобы администратор подтвердил ее выполнение. По умолчанию этот параметр имеет значение «$true».

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

ExternalUrl

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

System.Uri

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

InternalUrl

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

System.Uri

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

Path

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

System.String

Этот параметр указывает локальный путь на сервере клиентского доступа, где размещены файлы UMWebservice. По умолчанию используется путь %ExchangeInstallDir%\UnifiedMessaging\WebService.

TemplateInstance

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

System.Management.Automation.PSObject

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

WebSiteName

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

System.String

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

WindowsAuthentication

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

System.Boolean

Этот параметр указывает, следует ли включать встроенную проверку подлинности Windows для виртуального каталога.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

С помощью приведенного в примере кода создается новый виртуальный каталог единой системы обмена сообщениями с именем MyUMWeb.

New-UMVirtualDirectory -MyUMWeb -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/UMwebservices.aspx"