Командлет 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.
Примечание. |
---|
Если имеется набор серверов клиентского доступа, сбалансированных по нагрузке, при запуске данного командлета нет необходимости указывать имена всех серверов. Достаточно указать имя только одного сервера из группы объединенных в сеть серверов, сбалансированных по нагрузке. |
Для выполнения командлета 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