Set-WebServicesVirtualDirectory

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2011-06-21

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

Синтаксис

Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Set-WebServicesVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

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

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

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

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

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

Параметры

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

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

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

BasicAuthentication

Необязательный

System.Boolean

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

Confirm

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

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется.

DigestAuthentication

Необязательный

System.Boolean

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

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

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

ExternalUrl

Необязательный

System.Uri

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

Instance

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory

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

InternalNLBBypassUrl

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

System.Uri

Этот параметр указывает URL-адрес сервера клиентского доступа, даже если сервер клиентского доступа находится вне области действия балансировщика сетевой нагрузки.

InternalUrl

Необязательный

System.Uri

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

WhatIf

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

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется.

WindowsAuthentication

Необязательный

System.Boolean

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

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