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


Set-ActiveSyncVirtualDirectory

Этот командлет доступен только в локальной среде 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

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