Set-ActiveSyncVirtualDirectory

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Используйте командлет Set-ActiveSyncVirtualDirectory для изменения существующих Майкрософт Exchange ActiveSync виртуальных каталогов, используемых в службах IIS на серверах Exchange.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-ActiveSyncVirtualDirectory
   [-Identity] <VirtualDirectoryIdParameter>
   [-ActiveSyncServer <String>]
   [-BadItemReportingEnabled <Boolean>]
   [-BasicAuthEnabled <Boolean>]
   [-ClientCertAuth <ClientCertAuthTypes>]
   [-CompressionEnabled <Boolean>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExtendedProtectionFlags <MultiValuedProperty>]
   [-ExtendedProtectionSPNList <MultiValuedProperty>]
   [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
   [-ExternalAuthenticationMethods <MultiValuedProperty>]
   [-ExternalUrl <Uri>]
   [-InstallIsapiFilter <Boolean>]
   [-InternalAuthenticationMethods <MultiValuedProperty>]
   [-InternalUrl <Uri>]
   [-MobileClientCertificateAuthorityURL <String>]
   [-MobileClientCertificateProvisioningEnabled <Boolean>]
   [-MobileClientCertTemplateName <String>]
   [-Name <String>]
   [-RemoteDocumentsActionForUnknownServers <RemoteDocumentsActions>]
   [-RemoteDocumentsAllowedServers <MultiValuedProperty>]
   [-RemoteDocumentsBlockedServers <MultiValuedProperty>]
   [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>]
   [-SendWatsonReport <Boolean>]
   [-WhatIf]
   [-WindowsAuthEnabled <Boolean>]
   [<CommonParameters>]

Описание

Командлет Set-ActiveSyncVirtualDirectory настраивает различные параметры виртуального каталога, используемые для Exchange ActiveSync включая параметры безопасности, проверки подлинности, внутренних и внешних URL-адресов.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Set-ActiveSyncVirtualDirectory -Identity "contoso\Microsoft-Server-ActiveSync (Default Web Site)" -BasicAuthEnabled $false

В этом примере отключается обычная проверка подлинности в виртуальном каталоге по умолчанию Exchange ActiveSync на сервере Contoso.

Пример 2

Set-ActiveSyncVirtualDirectory -Identity "contoso\Microsoft-Server-ActiveSync (Default Web Site)" -BadItemReportingEnabled $true -SendWatsonReport:$true

В этом примере включается отчеты о недопустимых элементах и включается параметр отправки отчетов Watson об ошибках на сервере Contoso.

Пример 3

Set-ActiveSyncVirtualDirectory -Identity "contoso\Microsoft-Server-ActiveSync (Default Web Site)" -ExternalUrl "https://contoso.com/mail"

В этом примере настраивается внешний URL-адрес в виртуальном каталоге по умолчанию Exchange ActiveSync на сервере Contoso.

Параметры

-ActiveSyncServer

Параметр ActiveSyncServer указывает URL-адрес сервера почтовых ящиков. Это значение имеет следующий формат: https://servername/Microsoft-Server-ActiveSync.

Type:	String
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

-BadItemReportingEnabled

Параметр BadItemReportingEnabled указывает, следует ли сообщать пользователю элементы, которые не могут быть синхронизированы. Если задано значение $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

-BasicAuthEnabled

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

$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

-ClientCertAuth

Параметр ClientCertAuth указывает состояние проверки подлинности сертификата клиента. По умолчанию проверка подлинности сертификата клиента отключена. Значение по умолчанию — Игнорировать.

Type:	ClientCertAuthTypes
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

-CompressionEnabled

Параметр CompressionEnabled — это логическое значение, которое определяет сжатие, применяемое к указанному Exchange ActiveSync виртуальному каталогу. Значение по умолчанию — $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

-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

-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 ограничивает методы проверки подлинности, которые можно использовать для подключения к виртуальному каталогу извне брандмауэра. Допустимые значения:

Adfs
Обычный
Сертификат
Дайджест
Fba
Kerberos;
LiveIdBasic
LiveIdFba
LiveIdNegotiate
NegoEx
Переговоры
Ntlm
OAuth
WindowsIntegrated
WSSecurity

WSSecurity

Хотя вы можете указать любое из этих значений, независимо от того, работает ли метод проверки подлинности для внешних подключений, зависит от других факторов. Например:

Несмотря на то, что вы можете указать любое из этих значений, то, будет ли работать метод проверки подлинности для внутренних подключений, зависит других факторов. Пример:
Доступен ли метод проверки подлинности в виртуальном каталоге?

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-адрес, который используется для подключения к виртуальному каталогу не из сети с брандмауэром.

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

-Identity

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

Имя или Сервер\Имя
различающееся имя (DN);
GUID

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

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

-InstallIsapiFilter

Параметр InstallIsapiFilter указывает, установлен ли фильтр API сервера Интернета (ISAPI).

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

-InternalAuthenticationMethods

Параметр InternalAuthenticationMethods указывает методы проверки подлинности, поддерживаемые сервером, содержащим виртуальный каталог, при запросе доступа из брандмауэра сети. Если этот параметр не задан, можно использовать все методы проверки подлинности.

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

-InternalUrl

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

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

-MobileClientCertificateAuthorityURL

Параметр MobileClientCertificateAuthorityURL указывает URL-адрес центра сертификации (ЦС), используемого мобильным телефоном.

Type:	String
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

-MobileClientCertificateProvisioningEnabled

Параметр MobileClientCertificateProvisioningEnabled указывает, возвращает ли служба автообнаружения URL-адрес сервера служб сертификатов в XML-файле.

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

-MobileClientCertTemplateName

Параметр MobileClientCertTemplateName указывает имя шаблона для сертификата клиента.

Type:	String
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

-Name

Параметр Name указывает имя виртуального каталога Exchange ActiveSync.

Type:	String
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

-RemoteDocumentsActionForUnknownServers

Параметр RemoteDocumentsActionForUnknownServers указывает действие, которое происходит при Microsoft Windows SharePoint Services или Майкрософт запрос общей папки Windows через Exchange ActiveSync. При поступлении запроса Exchange ActiveSync ищет запрошенное имя узла в списках разрешенных и заблокированных. Если имя узла не найдено в любом списке, выполняется действие, указанное в этом параметре( Блокировать или Разрешить).

Type:	RemoteDocumentsActions
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

-RemoteDocumentsAllowedServers

Параметр RemoteDocumentsAllowedServers — это многозначное свойство, в котором перечислены все разрешенные серверы для удаленного доступа к документам.

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

-RemoteDocumentsBlockedServers

Параметр RemoteDocumentsBlockedServers — это многозначное свойство, в котором перечислены все заблокированные серверы для удаленного доступа к документам.

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

-RemoteDocumentsInternalDomainSuffixList

Параметр RemoteDocumentsInternalDomainSuffixList используется в организациях, которые не запускают службу windows INTERNET Name Service (WINS) в своей сети. В этих средах можно указать одно или несколько полных доменных имен, которые Exchange ActiveSync рассматривать как внутренние при получении запроса на удаленный доступ к файлам.

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

-SendWatsonReport

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

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

-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

-WindowsAuthEnabled

Параметр WindowsAuthEnabled указывает, включена ли встроенная проверка подлинности Windows. Значение по умолчанию — $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

Входные данные

Input types

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

Выходные данные

Output types

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

Поделиться через