Set-EcpVirtualDirectory
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Set-EcpVirtualDirectory для изменения виртуальных каталогов Exchange панель управления (ECP), которые используются в службах IIS на Майкрософт серверах Exchange. Виртуальный каталог ECP управляет Центром администрирования Exchange.
Интерфейс управления веб-интерфейсом ECP был представлен в Exchange Server 2010 году. В Exchange Server 2013 г. и Exchange Server 2016 г. виртуальные каталоги EAC и соответствующие командлеты управления по-прежнему используют в имени ECP. Эти командлеты можно использовать для управления виртуальными каталогами ECP на серверах Exchange 2010, Exchange 2013 и Exchange 2016.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-EcpVirtualDirectory
[-Identity] <VirtualDirectoryIdParameter>
[-AdfsAuthentication <Boolean>]
[-AdminEnabled <Boolean>]
[-BasicAuthentication <Boolean>]
[-Confirm]
[-DigestAuthentication <Boolean>]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalAuthenticationMethods <MultiValuedProperty>]
[-ExternalUrl <Uri>]
[-FormsAuthentication <Boolean>]
[-GzipLevel <GzipLevel>]
[-InternalUrl <Uri>]
[-OwaOptionsEnabled <Boolean>]
[-WhatIf]
[-WindowsAuthentication <Boolean>]
[<CommonParameters>] Описание
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -BasicAuthentication:$falseВ данном примере отключается обычная проверка подлинности в виртуальном каталоге ECP по умолчанию на сервере с именем Server01.
Пример 2
Set-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -AdminEnabled $falseВ этом примере отключается доступ в Интернет к EAC на сервере Server01.
Параметры
-AdfsAuthentication
Параметр AdfsAuthentication указывает, что виртуальный каталог ECP позволяет пользователям проходить проверку подлинности службы федерации Active Directory (AD FS) (AD FS). Этот параметр принимает значения $true или $false. Значение по умолчанию — $false.
Параметры проверки подлинности ADFS для командлетов Set-OwaVirtualDirectory и Set-EcpVirtualDirectory связаны между собой. Перед тем как присваивать параметру AdfsAuthentication командлета Set-OwaVirtualDirectory значение $true, необходимо задать значение $true для параметра AdfsAuthentication командлета Set-EcpVirtualDirectory. Кроме того, нужно присвоить значение $false параметру AdfsAuthentication командлета Set-OwaVirtualDirectory, прежде чем задавать значение $false для параметра AdfsAuthentication командлета Set-EcpVirtualDirectory.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AdminEnabled
Параметр AdminEnabled указывает, что к Центру администрирования Exchange нельзя получить доступ через Интернет. Дополнительные сведения см. в статье Отключение доступа к Центру администрирования Exchange. Этот параметр принимает значения $true или $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BasicAuthentication
Параметр BasicAuthentication указывает, включена ли обычная проверка подлинности в виртуальном каталоге. Допустимые значения:
- $true: включена обычная проверка подлинности. Это значение используется по умолчанию.
- $true. Обычная проверка подлинности включена. Это значение по умолчанию.
Этот параметр может использоваться вместе с параметром FormsAuthentication или с параметрами DigestAuthentication и WindowsAuthentication.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DigestAuthentication
Параметр DigestAuthentication указывает, включена ли дайджест-проверка подлинности в виртуальном каталоге. Допустимые значения:
- $true: включена дайджест-проверка подлинности.
- $true. Это значение используется по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExtendedProtectionFlags
Параметр ExtendedProtectionFlags задает настраиваемые параметры расширенной защиты для проверки подлинности в виртуальном каталоге. Допустимые значения:
- Нет: настройка по умолчанию.
- AllowDotlessSPN: требуется, если вы хотите использовать значения имени субъекта-службы (SPN), которые не содержат полных доменных имен (например, HTTP/ContosoMail вместо HTTP/mail.contoso.com). Имена субъектов-служб указываются с помощью параметра ExtendedProtectionSPNList. Этот параметр делает расширенную защиту для проверки подлинности менее безопасным, так как бесточечные сертификаты не являются уникальными, поэтому невозможно убедиться, что подключение клиента к прокси-серверу установлено через безопасный канал.
- NoServiceNameCheck: список имени субъекта-службы не проверяется для проверки маркера привязки канала. Этот параметр делает расширенную защиту для проверки подлинности менее безопасной. Обычно не рекомендуется использовать это значение.
- Прокси-сервер. Прокси-сервер отвечает за завершение SSL-канала. Чтобы использовать этот параметр, необходимо зарегистрировать имя субъекта-службы с помощью параметра ExtendedProtectionSPNList.
- ProxyCoHosting: трафик HTTP и HTTPS может обращаться к виртуальному каталогу, а прокси-сервер находится по крайней мере между некоторыми клиентами и службами клиентского доступа на сервере Exchange Server.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExtendedProtectionSPNList
Параметр ExtendedProtectionSPNList указывает список допустимых имен субъектов-служб (SPN), если вы используете расширенную защиту для проверки подлинности в виртуальном каталоге. Допустимые значения:
- $null: это значение по умолчанию.
- Список допустимых имен субъектов-служб с разделителями-запятыми или одно имя субъекта-службы: формат значения имени субъекта-службы —
Protocol\FQDN. Например, HTTP/mail.contoso.com. Чтобы добавить имя субъекта-службы, которое не является полным доменным именем (например, HTTP/ContosoMail), необходимо также использовать значение AllowDotlessSPN для параметра ExtendedProtectionFlags.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExtendedProtectionTokenChecking
Параметр ExtendedProtectionTokenChecking определяет способ использования расширенной защиты для проверки подлинности в виртуальном каталоге. Расширенная защита для проверки подлинности по умолчанию не включена. Допустимые значения:
- Нет. Расширенная защита для проверки подлинности не используется в виртуальном каталоге. Это значение используется по умолчанию.
- Разрешить. Расширенная защита для проверки подлинности используется для подключений между клиентами и виртуальным каталогом, если клиент и сервер поддерживают ее. Подключения, которые не поддерживают расширенную защиту для проверки подлинности, будут работать, но могут быть не столь безопасными, как подключения, использующие расширенную защиту для проверки подлинности.
- Требовать: расширенная защита для проверки подлинности используется для всех подключений между клиентами и виртуальным каталогом. Если клиент или сервер не поддерживают его, подключение завершится ошибкой. Если вы используете это значение, необходимо также задать значение имени субъекта-службы для параметра ExtendedProtectionSPNList.
Примечание. Если вы используете значение Разрешить или Требовать и у вас есть прокси-сервер между клиентом и службами клиентского доступа на сервере почтовых ящиков, настроенный для завершения ssl-канала типа "клиент —прокси", необходимо также настроить одно или несколько имен субъектов-служб (SPN) с помощью параметра ExtendedProtectionSPNList.
| Type: | ExtendedProtectionTokenCheckingMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalAuthenticationMethods
Параметр ExternalAuthenticationMethods указывает методы проверки подлинности, поддерживаемые на сервере Exchange Server за пределами брандмауэра.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalUrl
Параметр ExternalURL указывает URL-адрес, который используется для подключения к виртуальному каталогу не из сети с брандмауэром.
Этот параметр также очень важен, если используется протокол SSL. Этот параметр необходимо использовать, чтобы разрешить службе автообнаружения возвращать URL-адрес для виртуального каталога панели управления Exchange.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-FormsAuthentication
Параметр FormsAuthentication определяет, включена ли проверка подлинности на основе форм для виртуального каталога ECP. Допустимые значения:
- $true: включена проверка подлинности с помощью форм. Для параметра BasicAuthentication установлено значение $true, а для параметров DigestAuthentication и WindowsAuthentication — значение $false.
- $false. Проверка подлинности с помощью форм отключена.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GzipLevel
Параметр GzipLevel указывает данные конфигурации Gzip для виртуального каталога ECP.
| Type: | GzipLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Параметр Identity указывает виртуальный каталог ECP, который требуется изменить. Можно использовать любое уникальное значение, идентифицирующее виртуальный каталог. Например:
- Имя или Сервер\Имя
- различающееся имя (DN);
- GUID
Значение Name использует синтаксис "VirtualDirectoryName (WebsiteName)" из свойств виртуального каталога. Вместо веб-сайта по умолчанию можно указать подстановочный знак (*) с помощью синтаксиса VirtualDirectoryName*.
Чтобы управлять первым виртуальным каталогом ECP, созданным в организации Exchange, необходимо использовать этот командлет на компьютере, который включает первый виртуальный каталог ECP. Созданными дополнительными виртуальными каталогами ECP можно управлять удаленно.
| Type: | VirtualDirectoryIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalUrl
Параметр InternalURL указывает URL-адрес, который используется для подключения к виртуальному каталогу из сети с брандмауэром.
Этот параметр также очень важен, если используется SSL. Этот параметр необходимо использовать, чтобы разрешить службе автообнаружения возвращать URL-адрес для виртуального каталога панели управления Exchange.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OwaOptionsEnabled
Параметр OwaOptionsEnabled указывает, что параметры Outlook в Интернете включены для конечных пользователей. Если для этого параметра задано значение $false, пользователи не смогут получить доступ к параметрам Outlook в Интернете. Отключение доступа может понадобиться, если организация использует средства, предоставленные сторонним поставщиком. Этот параметр принимает значение $true или $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WindowsAuthentication
Параметр WindowsAuthentication указывает, включена ли встроенная проверка подлинности Windows в виртуальном каталоге. Допустимые значения:
- $true. Интегрированная проверка подлинности Windows включена. Это значение используется по умолчанию.
- $false. Встроенная проверка подлинности Windows отключена.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.