Командлет New-UMVirtualDirectory (окончательная первоначальная версия)
Применимо к: Exchange Server 2007
Последнее изменение раздела: 2007-06-11
Командлет New-UMVirtualDirectory используется для создания нового виртуального каталога на компьютере, на котором запущен сервер Microsoft Exchange Server 2007 с установленной ролью клиентского доступа.
Синтаксис
New-UMVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WindowsAuthentication <$true | $false>]
Подробное описание
Командлет New-UMVirtualDirectory используется для создания нового виртуального каталога единой системы обмена сообщениями на сервере клиентского доступа Exchange 2007. Можно создать один или несколько виртуальных каталогов единой системы обмена сообщениями.
Для выполнения командлета New-UMVirtualDirectory используемой учетной записи необходимо делегировать следующие полномочия:
- роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 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 |
Этот параметр используется, чтобы указать, требуется ли включать краткую проверку подлинности при получении доступа к виртуальному каталогу . |
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. |
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 проверка подлинности при доступе к виртуальному каталогу. |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Исключения
| Исключения | Описание |
|---|---|
|
|
Пример
С помощью приведенного в примере кода создается новый виртуальный каталог единой системы обмена сообщениями с именем MyUMWeb.
New-UMVirtualDirectory -MyUMWeb -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/UMwebservices.aspx"