New-WebServicesVirtualDirectory
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2007-08-20
Командлет New-WebServicesVirtualDirectory позволяет создать новый виртуальный каталог EWS на компьютере, на котором выполняется Microsoft Exchange Server 2007 и которому присвоена роль сервера клиентского доступа.
Синтаксис
New-WebServicesVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Подробное описание
Командлет New-WebServicesVirtualDirectory позволяет создать новый виртуальный каталог EWS на сервере клиентского доступа Exchange 2007. Используя этот командлет, можно создать несколько виртуальных каталогов.
.gif "note") Примечание. |
|---|
| На каждом веб-узле можно создать только один виртуальный каталог EWS. |
Для выполнения командлета New-WebServicesVirtualDirectory используемой учетной записи необходимо делегировать роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
ApplicationRoot |
Дополнительно |
System.String |
Этот параметр задает путь к метабазе виртуального каталога. По умолчанию этот путь указывается на веб-узле, в котором создан виртуальный каталог. |
AppPoolId |
Дополнительно |
System.String |
Этот параметр задает набор программ, которые могут использоваться с данным виртуальным каталогом. |
BasicAuthentication |
Дополнительно |
System.Boolean |
Этот параметр определяет, включена ли обычная проверка подлинности для виртуального каталога EWS. |
Confirm |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки обработки команды и требует от оператора указания действия, которое будет предпринято перед возобновлением обработки. Указывать значение параметра Confirm не требуется. |
DigestAuthentication |
Дополнительно |
System.Boolean |
Этот параметр (если он используется) указывает на использование краткой проверки подлинности виртуального каталога. |
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя (FQDN) контроллера домена, который записывает изменения конфигурации в службу каталогов Active Directory, включите параметр DomainController этого командлета. |
ExternalUrl |
Дополнительно |
System.Uri |
Этот параметр определяет имя компьютера, которое используется для подключения к серверу Exchange извне граничной сети. |
InternalNLBBypassUrl |
Дополнительно |
System.Uri |
Этот параметр указывает URL-адрес сервера клиентского доступа вне зависимости от того, находится ли он за пределами массива балансировки нагрузки на сеть (NLB). Хотя параметр InternalUrl будет выставлен для URL-адреса NLB, параметр InternalNLBBypassUrl всегда должен выставляться для URL-адреса сервера клиентского доступа. Это необходимо, поскольку определенные вызовы веб-служб Exchange требуют машинного сходства, а веб-службы Exchange при любой возможности будут передавать вызовы на наиболее подходящий сервер клиентского доступа. |
InternalUrl |
Дополнительно |
System.Uri |
Этот параметр задает адрес URL, используемый для подключения к виртуальному каталогу изнутри межсетевого экрана сети. |
Path |
Дополнительно |
System.String |
Этот параметр задает путь виртуального каталога в метабазе. |
TemplateInstance |
Дополнительно |
System.Management.Automation.PSObject |
Если в этом параметре указан существующий объект, команда использует конфигурацию этого объекта для создания копии объекта на локальном или целевом сервере. |
WebSiteName |
Дополнительно |
System.String |
Этот параметр позволяет указать имя веб-узла, на котором необходимо создать виртуальный каталог. Этот параметр не должен использоваться при создании нового виртуального каталога на веб-узле по умолчанию. |
WindowsAuthentication |
Дополнительно |
System.Boolean |
Этот параметр позволяет указать, разрешена ли интегрированная проверка подлинности Windows в новом виртуальном каталоге веб-служб Exchange. |
WhatIf |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется. |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Исключения
| Исключения | Описание |
|---|---|
|
|
Пример
В этом примере кода создан новый виртуальный каталог «contoso» с внешним URL-адресом: https://www.contoso.com/webservices.aspx.
New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"