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.
.gif "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