Командлет 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 -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 [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Параметры

Параметр	Обязательный	Тип	Описание
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.

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

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

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

Примечание.

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

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

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

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

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

Ошибки

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

Исключения

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

Пример

В следующем примере кода в качестве метода проверки подлинности устанавливается обычная проверка подлинности для виртуального каталога с именем «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

Копировать код

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