Командлет 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 -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>]

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

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

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