Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Командлет Set-WebServicesVirtualDirectory позволяет изменить существующий виртуальный каталог веб-служб Exchange на сервере под управлением Microsoft Exchange Server 2010, на котором установлена роль сервера клиентского доступа.
Синтаксис
Set-WebServicesVirtualDirectory -Identity
<VirtualDirectoryIdParameter> [-BasicAuthentication <$true
| $false>] [-CertificateAuthentication <$true | $false>]
[-Confirm [<SwitchParameter>]] [-DigestAuthentication
<$true | $false>] [-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <None | Allow | Require>]
[-ExternalUrl <Uri>] [-Force <SwitchParameter>]
[-GzipLevel <Off | Low | High | Error>]
[-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>]
[-LiveIdBasicAuthentication <$true | $false>]
[-LiveIdSpNegoAuthentication <$true | $false>]
[-UpdateManagementVirtualDirectory <SwitchParameter>]
[-WhatIf [<SwitchParameter>]] [-WindowsAuthentication
<$true | $false>] [-WSSecurityAuthentication <$true |
$false>]
|
Параметры
Параметр | Обязательный | Тип | Описание | ||||
---|---|---|---|---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Параметр Identity определяет имя виртуального каталога. Кроме того, вместо веб-сайта по умолчанию можно указать подстановочный знак. |
||||
BasicAuthentication |
Необязательный |
System.Boolean |
Параметр BasicAuthentication указывает, включена ли обычная проверка подлинности для виртуального каталога веб-служб Exchange. Этот параметр можно использовать совместно с параметрами DigestAuthentication и WindowsAuthentication. |
||||
CertificateAuthentication |
Необязательный |
System.Boolean |
Параметр CertificateAuthentication указывает, включена ли проверка подлинности сертификата. Данный параметр влияет на виртуальный каталог <Имя_сервера>/ews/management/. Он не влияет на виртуальный каталог <Имя_сервера>/ews/. |
||||
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
|||||
DigestAuthentication |
Необязательный |
System.Boolean |
Параметр DigestAuthentication указывает, включена ли дайджест-проверка подлинности для доступа к виртуальному каталогу. |
||||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
|||||
ExtendedProtectionFlags |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ExtendedProtectionFlags используется для выполнения настройки в случае использования расширенной защиты для проверки подлинности. Возможные значения:
|
||||
ExtendedProtectionSPNList |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр ExtendedProtectionSPNList задает список действительных имен участников-служб в случае использования расширенной защиты для проверки подлинности в указанном виртуальном каталоге. Возможные значения:
|
||||
ExtendedProtectionTokenChecking |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ExtendedProtectionTokenCheckingMode |
Параметр ExtendedProtectionTokenChecking определяет порядок использования расширенной защиты для проверки подлинности в указанном виртуальном каталоге Exchange. Расширенная защита для проверки подлинности по умолчанию не включена. Имеются следующие параметры:
Дополнительные сведения о расширенной защите для проверки подлинности см. в разделе Общие сведения о расширенной защите для проверки подлинности . |
||||
ExternalUrl |
Необязательный |
System.Uri |
Параметр ExternalUrl указывает имя узла, используемое для подключения к серверу Exchange за пределами из брандмауэра. Этот параметр также очень важен, если используется протокол SSL. |
||||
Force |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Force указывает, необходимо ли предотвращать отображение предупреждающих или подтверждающих сообщений при выполнении определенных изменений конфигурации. |
||||
GzipLevel |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.GzipLevel |
Параметр GzipLevel задает сведения о конфигурации Gzip для виртуального каталога веб-служб Exchange. Для этого параметра могут быть установлены следующие значения:
|
||||
InternalNLBBypassUrl |
Необязательный |
System.Uri |
Параметр InternalNLBBypassUrl указывает URL-адрес сервера клиентского доступа вне зависимости от того, находится ли он в пределах массива балансировки сетевой нагрузки, или нет. Хотя для параметра InternalUrl устанавливается URL-адрес массива балансировки сетевой нагрузки, в качестве значения для параметра InternalNLBBypassUrl всегда необходимо устанавливать URL-адрес сервера клиентского доступа. Это необходимо, поскольку определенные вызовы веб-служб Exchange требуют машинного сходства, а веб-службы Exchange при любой возможности будут передавать вызовы на наиболее подходящий сервер клиентского доступа. |
||||
InternalUrl |
Необязательный |
System.Uri |
Параметр InternalUrl указывает имя узла сервера Exchange, используемое для подключений, исходящих из области действия брандмауэра. Этот параметр также очень важен, если используется SSL. |
||||
LiveIdBasicAuthentication |
Необязательный |
System.Boolean |
|||||
LiveIdSpNegoAuthentication |
Необязательный |
System.Boolean |
|||||
UpdateManagementVirtualDirectory |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр UpdateManagementVirtualDirectory гарантирует, что объекты веб-служб Exchange в Служба каталогов Active Directory и соответствующие объекты в службах IIS обновлены и согласованы. |
||||
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
|||||
WindowsAuthentication |
Необязательный |
System.Boolean |
Параметр WindowsAuthentication определяет, разрешена ли встроенная проверка подлинности Windows для доступа к виртуальному каталогу веб-служб Exchange. |
||||
WSSecurityAuthentication |
Необязательный |
System.Boolean |
Параметр WSSecurityAuthentication указывает, включена ли проверка подлинности WS-Security для виртуального каталога веб-служб Exchange. Этот параметр можно использовать совместно с параметрами BasicAuthentication, DigestAuthentication и WindowsAuthentication. |
Подробное описание
Если имеется набор серверов клиентского доступа, сбалансированных по нагрузке, при выполнении команды не требуется указывать имя каждого сервера отдельно. Достаточно указать имя только одного сервера из группы сбалансированных по сетевой нагрузке серверов.
Запись «Параметры виртуального каталога веб-служб Exchange» в разделе Разрешения клиентского доступа.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Примеры
ПРИМЕР 1
В этом примере в качестве метода проверки подлинности устанавливается обычная проверка подлинности для виртуального каталога с именем 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/exchange.asmx |
ПРИМЕР 2
В данном примере используется подстановочный знак вместо веб-сайта по умолчанию, использованного в Примере 1.
Скопировать код | |
---|---|
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/EWS/exchange.asmx |