Set-UMVirtualDirectory
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2008-11-10
Командлет 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>]
Подробное описание
Командлет Set-UMVirtualDirectory позволяет изменить существующий виртуальный каталог веб-служб Exchange на сервере клиентского доступа Exchange 2007.
Для выполнения командлета Set-UMVirtualDirectory используемой учетной записи необходимо делегировать роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Exchange 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Этот параметр задает имя виртуального каталога. Кроме того, вместо веб-сайта по умолчанию можно указать подстановочный знак. |
BasicAuthentication |
Необязательный |
System.Boolean |
Этот параметр указывает, включена ли обычная проверка подлинности для доступа к виртуальному каталогу веб-служб Exchange. Этот параметр можно использовать с параметром FormsAuthentication или с параметрами DigestAuthentication и WindowsAuthentication. |
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр используется для приостановки обработки команды. Для продолжения обработки администратор должен подтвердить действие, выполняемое командой. Значение по умолчанию: |
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 для просмотра изменений, которые произойдут при выполнении команды, без применения всех этих изменений. Значение по умолчанию: |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Исключения
| Исключения | Описание |
|---|---|
|
|
Пример
В первом примере кода для виртуального каталога единой системы обмена сообщениями на сервере 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