Set-OabVirtualDirectory

 

Применимо к:Exchange Server 2016

Последнее изменение раздела:2018-01-16

Этот командлет доступен только в локальной среде Exchange.

Командлет Set-OABVirtualDirectory используется для изменения виртуальных каталогов автономной адресной книги, используемых в Службы IIS (IIS) на серверах Exchange.

Сведения о наборах параметров, указанных в разделе "Синтаксис" ниже, см. в статье Синтаксис командлетов Exchange.

Set-OabVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExtendedProtectionFlags <MultiValuedProperty>] [-ExtendedProtectionSPNList <MultiValuedProperty>] [-ExtendedProtectionTokenChecking <None | Allow | Require>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OAuthAuthentication <$true | $false>] [-PollInterval <Int32>] [-RequireSSL <$true | $false>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

В этом примере изменяется внешний URL-адрес автономной адресной книги виртуального каталога (Default Web Site) на https://www.contoso.com/OAB.

Set-OABVirtualDirectory -Identity "Server1\OAB (Default Web Site)" -ExternalUrl "https://www.contoso.com/OAB"

Для запуска этого командлета необходимо получить соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделеРазрешения для электронных адресов и адресных книг, подраздел "Подключение автономной адресной книги".

 

Параметр Обязательный Тип Описание

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

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

Можно использовать любое уникальное значение, идентифицирующее виртуальный каталог. Например:

  • Имя или <Server>\Name

  • Различающееся имя (DN)

  • GUID

Для значения Name используется синтаксис "<VirtualDirectoryName> (<WebsiteName>)" из свойств виртуального каталога. Вместо веб-сайта, используемого по умолчанию, вы можете указать подстановочный знак (*), использовав синтаксис <VirtualDirectoryName>*.

BasicAuthentication

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

System.Boolean

Параметр BasicAuthentication указывает, включена ли обычная проверка подлинности для виртуального каталога. Допускаются следующие значения:

  • $true. Обычная проверка подлинности включена. Это значение по умолчанию.

  • $false. Обычная проверка подлинности отключена.

Вы можете использовать этот параметр вместе с параметром WindowsAuthentication.

Confirm

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

System.Management.Automation.SwitchParameter

Параметр Confirm указывает, следует ли отображать запрос на подтверждение. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Для командлетов, которые могут нарушить работу системы (например, Remove-*), требуется подтверждение. Вы можете пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.

  • Для большинства других командлетов (например, командлетов New-* и Set-*) не требуется подтверждение. Если для этих командлетов указать параметр Confirm без значения, то перед их выполнением будет отображаться запрос на подтверждение.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController задает контроллер домена, который используется этим командлетом для чтения данных из службы каталогов Active Directory или записи данных в нее. Укажите контроллер домена с использованием его полного доменного имени (FQDN). Например, dc01.contoso.com.

ExtendedProtectionFlags

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ExtendedProtectionFlags определяет особые параметры расширенной защиты для проверки подлинности в виртуальном каталоге. Допускаются следующие значения:

  • None. Это значение по умолчанию.

  • AllowDotlessSPN Требуется, если вы хотите использовать значения имен субъектов-служб, не содержащие FQDN (например, HTTP/ContosoMail вместо HTTP/mail.contoso.com). Вы указываете имена субъектов-служб с помощью параметра ExtendedProtectionSPNList. Этот параметр делает расширенную защиту для проверки подлинности менее надежной, так как сертификаты без точек не являются уникальными и невозможно гарантировать подключение клиента к прокси-серверу по безопасному каналу.

  • NoServiceNameCheck Маркер привязки канала не проверяется по списку имен субъектов-служб. Этот параметр делает расширенную защиту для проверки подлинности менее надежной. Не рекомендуем использовать этот параметр.

  • Proxy. Прокси-сервер отвечает за завершение канала SSL. Чтобы использовать этот параметр, вам потребуется зарегистрировать имя субъекта-службы с помощью параметра ExtendedProtectionSPNList.

  • ProxyCoHosting HTTP- и HTTPS-трафику доступен виртуальный каталог, и по крайней мере между некоторыми клиентами и службами клиентского доступа на сервере Exchange расположен прокси-сервер.

ExtendedProtectionSPNList

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

Microsoft.Exchange.Data.MultiValuedProperty

Если вы используете расширенную защиту для проверки подлинности в виртуальном каталоге, параметр ExtendedProtectionSPNList определяет список допустимых имен субъектов-служб. Допускаются следующие значения:

  • $null. Это значение по умолчанию.

  • Одно имя субъекта-службы или список допустимых имен субъектов-служб, разделенных запятыми. Значение имени субъекта-службы имеет следующий формат: <protocol>/<FQDN>. Пример: HTTP/mail.contoso.com. Чтобы добавить имя субъекта-службы, отличное от FQDN (например, HTTP/ContosoMail), вам потребуется присвоить параметру ExtendedProtectionFlags значение AllowDotlessSPN.

ExtendedProtectionTokenChecking

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ExtendedProtectionTokenCheckingMode

Параметр ExtendedProtectionTokenChecking определяет порядок использования расширенной защиты для проверки подлинности в виртуальном каталоге. По умолчанию расширенная защита для проверки подлинности отключена. Допускаются следующие значения:

  • None. В каталоге не используется расширенная защита для проверки подлинности. Это значение по умолчанию.

  • Allow. Расширенная защита для проверки подлинности используется для подключений между клиентами и виртуальным каталогом, если и клиент, и сервер поддерживают ее. Вы сможете использовать подключения, не поддерживающие расширенную защиту для проверки подлинности, но они могут быть менее надежными.

noteПримечание.
Если у вас есть прокси-сервер между клиентом и службами клиентского доступа на сервере почтовых ящиков, настроенный для завершения SSL-канала между клиентом и прокси-сервером, вам также потребуется настроить одно или несколько имен субъектов-служб с помощью параметра ExtendedProtectionSPNList.
  • Require. Расширенная защита для проверки подлинности используется для всех подключений между клиентами и виртуальным каталогом. Если клиент или сервер не поддерживает ее, то создать подключение не удастся. Если вы используете это значение, вам также потребуется задать значение имени субъекта-службы для параметра ExtendedProtectionSPNList.

noteПримечание.
Если у вас есть прокси-сервер между клиентом и службами клиентского доступа на сервере Exchange, настроенный для завершения SSL-канала между клиентом и прокси-сервером, вам также потребуется настроить одно или несколько имен субъектов-служб с помощью параметра ExtendedProtectionSPNList.

ExternalUrl

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

System.Uri

Параметр ExternalURL указывает URL-адрес, который используется для подключения к виртуальному каталогу не из сети с брандмауэром.

InternalUrl

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

System.Uri

Параметр InternalURL указывает URL-адрес, который используется для подключения к виртуальному каталогу из сети с брандмауэром.

OAuthAuthentication

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

System.Boolean

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

PollInterval

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

System.Int32

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

RequireSSL

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

System.Boolean

Параметр RequireSSL указывает, необходимо ли использовать SSL-шифрование подключения клиента к виртуальному каталогу. Допускаются следующие значения:

  • $true   Для подключения к виртуальному каталогу требуется использовать SSL-шифрование. Это значение по умолчанию.

  • $false   Для подключения к виртуальному каталогу не требуется использовать SSL-шифрование.

WhatIf

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

System.Management.Automation.SwitchParameter

Параметр WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. Указывать значение для этого параметра не обязательно.

WindowsAuthentication

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

System.Boolean

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

  • $true. Интегрированная проверка подлинности Windows включена. Это значение по умолчанию.

  • $false. Интегрированная проверка подлинности Windows отключена.

Вы можете использовать этот параметр вместе с параметром BasicAuthentication.

Типы входных данных, поддерживаемые этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы входных данных" для командлета пустое, этот командлет не поддерживает ввода данных.

Типы возвращаемых данных, или типы выходных данных, которые поддерживаются этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы выходных данных" пустое, командлет не возвращает данные.

 
Показ: