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"