Поделиться через


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. Используя этот командлет, можно создать несколько виртуальных каталогов.

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"