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

Синтаксис

Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-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

Этот параметр используется для приостановки обработки команды. Для продолжения обработки администратор должен подтвердить действие, выполняемое командой. Значение по умолчанию: $true.

DigestAuthentication

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

System.Boolean

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

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

ExternalUrl

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

System.Uri

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

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADUMVirtualDirectory

Этот параметр определяет, следует ли передать в командлет для обработки весь объект. Параметр обычно применяется в сценариях, где командлету должен быть передан целый объект.

InternalUrl

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

System.Uri

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

WindowsAuthentication

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

System.Boolean

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

WhatIf

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

System.Management.Automation.SwitchParameter

Этот параметр заставляет команду имитировать действия, которые она будет выполнять над объектом. Администратор может использовать параметр WhatIf для просмотра изменений, которые произойдут при выполнении команды, без применения всех этих изменений. Значение по умолчанию: $true.

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

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

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

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

Копировать код
Set-UMVirtualDirectory -Identity UMServer1\UnifiedMessaging -ExternalUrl https://www.contoso.com/UnifiedMessaging/service.asmx -ExternalAuthenticationMethods Digest -InternalUrl https://contoso.internal.com/UnifiedMessaging/service.asmx
Set-UMVirtualDirectory -Identity UMServer1\UnifiedMessaging* -ExternalUrl https://www.contoso.com/UnifiedMessaging/service.asmx