Set-OutlookAnywhere
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Set-OutlookAnywhere для изменения виртуальных каталогов Outlook Anywhere, которые используются в службах IIS на серверах Microsoft Exchange. Outlook Anywhere использует виртуальные каталоги, содержащие rpc в имени.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Set-OutlookAnywhere
[-Identity] <VirtualDirectoryIdParameter>
[-ClientAuthenticationMethod <AuthenticationMethod>]
[-Confirm]
[-DefaultAuthenticationMethod <AuthenticationMethod>]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalClientAuthenticationMethod <AuthenticationMethod>]
[-ExternalClientsRequireSsl <Boolean>]
[-ExternalHostname <Hostname>]
[-IISAuthenticationMethods <MultiValuedProperty>]
[-InternalClientAuthenticationMethod <AuthenticationMethod>]
[-InternalClientsRequireSsl <Boolean>]
[-InternalHostname <String>]
[-Name <String>]
[-SSLOffloading <Boolean>]
[-WhatIf]
[<CommonParameters>]
Описание
Дополнительные сведения о различных методах проверки подлинности, которые можно найти в этой статье, см. в статье Общие сведения о проверке подлинности HTTP.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-OutlookAnywhere -Identity:CAS01\Rpc (Default Web Site) -ClientAuthenticationMethod:Ntlm
В Exchange 2010 этот пример задает для метода проверки подлинности клиента значение NTLM для виртуального каталога /rpc на сервере клиентского доступа CAS01.
Пример 2
Set-OutlookAnywhere -Identity: "EXCH1\rpc (Default Web Site)" -ExternalClientAuthenticationMethod NTLM
В этом примере для метода проверки подлинности клиента задается значение NTLM для виртуального каталога Outlook Anywhere на сервере с именем EXCH1.
Пример 3
Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -SSLOffloading $false -InternalClientsRequireSsl $true -ExternalClientsRequireSsl $true
В этом примере для параметра SSLOffloading задается значение $false для виртуального каталога Outlook Anywhere на сервере с именем EXCH1. Этот параметр информирует Outlook Anywhere о необходимости не расшифровывать SSL между клиентами и сервером и включает значение Требовать SSL в виртуальном каталоге. Так как ssl теперь требуется для подключений Outlook Anywhere, необходимо настроить внутренние и внешние клиенты для использования SSL.
Пример 4
Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -IISAuthenticationMethods NTLM
В этом примере для параметра виртуального каталога Outlook Anywhere в IIS задается метод проверки подлинности NTLM.
Пример 5
Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -IISAuthenticationMethods Basic,NTLM
В Exchange 2010 и Exchange 2013 этот пример задает доступные методы проверки подлинности для параметра виртуального каталога /rpc в IIS, чтобы использовать обычную проверку подлинности и проверку подлинности NTLM. После установки этого значения можно использовать виртуальный каталог IIS для обработки проверки подлинности для нескольких приложений, которым требуются различные методы проверки подлинности.
Параметры
-ClientAuthenticationMethod
Применимо: Exchange Server 2010 г.
Этот параметр доступен только в Exchange Server 2010.
Параметр ClientAuthenticationMethod указывает метод проверки подлинности, который служба автообнаружения предоставляет клиентам Outlook Anywhere для проверки подлинности на сервере клиентского доступа. Допустимые значения:
- Обычный
- Ntlm
Хотя этот параметр можно использовать для задания только одного метода проверки подлинности, команда не возвращает ошибку при включении нескольких значений.
Свойства параметров
| Тип: | AuthenticationMethod |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DefaultAuthenticationMethod
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр DefaultAuthenticationMethod указывает метод проверки подлинности по умолчанию для Любого Outlook. Этот параметр заменяет существующие значения свойств ExternalClientAuthenticationMethod, InternalClientAuthenticationMethod и IISAuthenticationMethod на указанное значение. Допустимые значения:
- Обычный
- Ntlm
- Вести переговоры
Этот параметр нельзя использовать с параметрами ExternalClientAuthenticationMethod, InternalClientAuthenticationMethod и IISAuthenticationMethods.
Свойства параметров
| Тип: | AuthenticationMethod |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExtendedProtectionFlags
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр ExtendedProtectionFlags задает настраиваемые параметры расширенной защиты для проверки подлинности в виртуальном каталоге. Допустимые значения:
- Нет: настройка по умолчанию.
- AllowDotlessSPN: требуется, если вы хотите использовать значения имени субъекта-службы (SPN), которые не содержат полных доменных имен (например, HTTP/ContosoMail вместо HTTP/mail.contoso.com). Имена субъектов-служб указываются с помощью параметра ExtendedProtectionSPNList. Этот параметр делает расширенную защиту для проверки подлинности менее безопасным, так как бесточечные сертификаты не являются уникальными, поэтому невозможно убедиться, что подключение клиента к прокси-серверу установлено через безопасный канал.
- NoServiceNameCheck: список имени субъекта-службы не проверяется для проверки маркера привязки канала. Этот параметр делает расширенную защиту для проверки подлинности менее безопасной. Обычно не рекомендуется использовать это значение.
- Прокси-сервер. Прокси-сервер отвечает за завершение SSL-канала. Чтобы использовать этот параметр, необходимо зарегистрировать имя субъекта-службы с помощью параметра ExtendedProtectionSPNList.
- ProxyCoHosting: трафик HTTP и HTTPS может обращаться к виртуальному каталогу, а прокси-сервер находится между по крайней мере некоторыми клиентами и службами клиентского доступа на сервере Exchange Server.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExtendedProtectionSPNList
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр ExtendedProtectionSPNList указывает список допустимых имен субъектов-служб (SPN), если вы используете расширенную защиту для проверки подлинности в виртуальном каталоге. Допустимые значения:
- $null: это значение по умолчанию.
- Список допустимых имен субъектов-служб с разделителями-запятыми или одно имя субъекта-службы: формат значения имени субъекта-службы —
Protocol\FQDN. Например, HTTP/mail.contoso.com. Чтобы добавить имя субъекта-службы, которое не является полным доменным именем (например, HTTP/ContosoMail), необходимо также использовать значение AllowDotlessSPN для параметра ExtendedProtectionFlags.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExtendedProtectionTokenChecking
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр ExtendedProtectionTokenChecking определяет способ использования расширенной защиты для проверки подлинности в виртуальном каталоге. Расширенная защита для проверки подлинности по умолчанию не включена. Допустимые значения:
- Нет. Расширенная защита для проверки подлинности не используется в виртуальном каталоге. Это значение является значением по умолчанию.
- Разрешить. Расширенная защита для проверки подлинности используется для подключений между клиентами и виртуальным каталогом, если клиент и сервер поддерживают ее. Connections, которые не поддерживают расширенную защиту для проверки подлинности, работают, но могут быть не так безопасны, как подключения, использующие расширенную защиту для проверки подлинности.
- Требовать: расширенная защита для проверки подлинности используется для всех подключений между клиентами и виртуальным каталогом. Если клиент или сервер не поддерживают его, подключение завершится ошибкой. Если вы используете это значение, необходимо также задать значение имени субъекта-службы для параметра ExtendedProtectionSPNList.
Примечание. Если вы используете значение Разрешить или Требовать и у вас есть прокси-сервер между клиентом и службами клиентского доступа на сервере почтовых ящиков, который настроен на завершение ssl-канала типа "клиент—прокси", необходимо также настроить одно или несколько имен субъектов-служб (SPN) с помощью параметра ExtendedProtectionSPNList.
Свойства параметров
| Тип: | ExtendedProtectionTokenCheckingMode |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalClientAuthenticationMethod
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр ExternalClientAuthenticationMethod указывает метод проверки подлинности, используемый для проверки подлинности внешних клиентов Outlook Anywhere. Допустимые значения:
- Обычный
- Ntlm
- Согласование (значение по умолчанию)
Этот параметр не может использоваться вместе с параметром DefaultAuthenticationMethods.
Свойства параметров
| Тип: | AuthenticationMethod |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalClientsRequireSsl
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр ExternalClientsRequireSsl указывает, требуются ли внешние клиенты Outlook Anywhere для использования SSL. Допустимые значения:
- $true. Клиенты, подключающиеся через Outlook Anywhere извне организации, должны использовать SSL.
- $false: клиенты, подключающиеся через Outlook Anywhere извне организации, не обязаны использовать SSL. Это значение является значением по умолчанию.
Значение этого параметра связано со значением параметра SSLOffloading.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExternalHostname
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр ExternalHostname указывает имя внешнего узла для виртуального каталога Outlook Anywhere. Например, mail.contoso.com.
Свойства параметров
| Тип: | Hostname |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр Identity указывает виртуальный каталог Outlook Anywhere, который требуется изменить. Можно использовать любое уникальное значение, идентифицирующее виртуальный каталог. Например:
- Имя или Сервер\Имя
- различающееся имя (DN);
- GUID
Значение Name использует синтаксис "VirtualDirectoryName (WebsiteName)" из свойств виртуального каталога. Вместо веб-сайта по умолчанию можно указать подстановочный знак (*) с помощью синтаксиса VirtualDirectoryName*.
Свойства параметров
| Тип: | VirtualDirectoryIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IISAuthenticationMethods
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр IISAuthenticationMethods указывает метод проверки подлинности, используемый в виртуальном каталоге Outlook Anywhere в IIS. Допустимые значения:
- Обычный
- Ntlm
- Вести переговоры
Можно указать несколько значений, разделенных запятыми. По умолчанию используются все значения.
Этот параметр не может использоваться вместе с параметром DefaultAuthenticationMethods.
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InternalClientAuthenticationMethod
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр InternalClientAuthenticationMethod указывает метод проверки подлинности, используемый для проверки подлинности внутренних клиентов Outlook Anywhere. Допустимые значения:
- Обычный
- Ntlm (значение по умолчанию)
- Вести переговоры
Этот параметр не может использоваться вместе с параметром DefaultAuthenticationMethods.
Свойства параметров
| Тип: | AuthenticationMethod |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InternalClientsRequireSsl
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр InternalClientsRequireSsl указывает, требуются ли внутренние клиенты Outlook Anywhere для использования SSL. Допустимые значения:
- $true: клиенты, подключающиеся через Outlook Anywhere из организации, должны использовать SSL.
- $false. Клиенты, подключающиеся через Мобильный Outlook из организации, не обязаны использовать SSL. Это значение является значением по умолчанию.
Значение этого параметра связано со значением параметра SSLOffloading.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InternalHostname
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр InternalHostname указывает внутреннее имя узла для виртуального каталога Outlook Anywhere. Например, mail.contoso.com.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр Name указывает имя виртуального каталога Outlook Anywhere. По умолчанию значение равно Rpc (Default Web Site). Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SSLOffloading
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Параметр SSLOffloading указывает, принимает ли сетевое устройство SSL-подключения и расшифровывает их перед прокси-сервером подключений к виртуальному каталогу Outlook Anywhere на сервере Exchange Server. Допустимые значения:
- $true. Клиенты Outlook Anywhere, использующие SSL, не поддерживают SSL-подключение по всему сетевому пути к серверу Exchange Server. Сетевое устройство перед сервером расшифровывает SSL-подключения и прокси-серверы незашифрованных клиентских подключений (HTTP) к виртуальному каталогу Outlook Anywhere. Сегмент сети, в котором используется ПРОТОКОЛ HTTP, должен быть защищенной сетью. Это значение является значением по умолчанию.
- $false. Клиенты Outlook Anywhere, использующие SSL, поддерживают SSL-подключение по всему сетевому пути к серверу Exchange Server. К виртуальному каталогу Outlook Anywhere разрешены только SSL-подключения.
Этот параметр настраивает значение Требовать SSL в виртуальном каталоге Outlook Anywhere. При установке для этого параметра значения $true параметр Требовать SSL отключен. При установке для этого параметра значения $fase параметр Требовать SSL включен. Однако может потребоваться несколько минут, прежде чем изменения будут видны в диспетчере IIS.
Если для этого параметра не требуются SSL-подключения для внутренних или внешних клиентов Outlook Anywhere, необходимо использовать значение $true.
Значение этого параметра связано со значениями параметров ExternalClientsRequireSsl и InternalClientsRequireSsl.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г.
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.