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


Командлет Set-WebServicesVirtualDirectory (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

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

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

Синтаксис

Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Url>] [-InternalUrl <Url>] [-WindowsAuthentication <$true | $false>]

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

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

noteПримечание.
Если имеется набор серверов клиентского доступа, сбалансированных по нагрузке, при запуске данного командлета нет необходимости указывать имена всех серверов. Достаточно указать имя только одного сервера из группы объединенных в сеть серверов, сбалансированных по нагрузке.

Для выполнения командлета Set-WebServicesVirtualDirectory используемой учетной записи необходимо делегировать:

  • роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

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

Параметры

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

Идентификатор

Обязательность

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

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

BasicAuthentication

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

System.Boolean

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

DigestAuthentication

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

System.Boolean

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

DomainController

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

System.String

Чтобы указать полное доменное имя контроллера домена, получающего данные из службы каталогов Active Directory, включите в командлет параметр DomainController.

ExternalUrl

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

System.Uri

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

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory

Параметр Instance позволяет передать в обрабатываемый командлет весь объект.

InternalUrl

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

System.Uri

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

WindowsAuthentication

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

System.Boolean

Этот параметр указывает, разрешена ли встроенная проверка подлинности Windows для доступа к виртуальному каталогу веб-служб Exchange.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующем примере кода в качестве метода проверки подлинности устанавливается обычная проверка подлинности для виртуального каталога с именем «EWS» на сервере «Contoso». В данном примере кода также определяются внутренний и внешний URL-адреса этого виртуального каталога.

Во втором примере кода вместо «веб-узла по умолчанию» используется подстановочный знак.

Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.aspx -ExternalAuthenticationMethods Basic -InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.aspx