Set-ActiveSyncVirtualDirectory

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2012-03-26

Командлет Set-ActiveSyncVirtualDirectory позволяет настроить параметры Microsoft Exchange ActiveSync для указанного виртуального каталога.

Синтаксис

Set-ActiveSyncVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Подробное описание

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

Чтобы выполнить командлет Set-ActiveSyncVirtualDirectory, используемой учетной записи необходимо делегировать роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

Этот параметр содержит уникальное определение виртуального каталога Exchange ActiveSync, который нужно настроить. Значение этого параметра должно иметь вид веб-узел\microsoft-server-activesync.

ActiveSyncServer

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

System.String

Этот параметр указывает URL-адрес сервера клиентского доступа. Его значение должно иметь следующий формат: https://имя_сервера/Microsoft-Server-ActiveSync.

BadItemReportingEnabled

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

System.Boolean

Этот параметр указывает, следует ли сообщать пользователю об элементах, которые не удается синхронизировать. При значении $true для этого параметра пользователь будет получать сообщение в том случае, если элемент не удается синхронизировать с мобильным устройством.

BasicAuthEnabled

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

System.Boolean

Этот параметр включает и отключает обычную проверку подлинности. Значение по умолчанию — $true.

ClientCertAuth

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes

Этот параметр указывает состояние проверки подлинности сертификата клиента. По умолчанию проверка подлинности сертификата клиента отключена. По умолчанию значение этого параметра — $null.

CompressionEnabled

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

System.Boolean

Данный параметр представлен целым числом, с помощью которого задается степень сжатия указанного виртуального каталога Exchange ActiveSync. Значение по умолчанию — $true.

Confirm

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

System.Management.Automation.SwitchParameter

Этот параметр используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController.

ExternalAuthenticationMethods

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр определяет методы проверки подлинности, поддерживаемые сервером, на котором находится виртуальный каталог, при запросе доступа снаружи межсетевого экрана сети. Если этот параметр не задан, могут использоваться любые методы проверки подлинности.

ExternalUrl

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

System.Uri

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

InstallIsapiFilter

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

System.Boolean

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

InstallProxySubDirectory

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

System.Boolean

Параметр InstallProxySubDirectory позволяет управлять способом создания подкаталога Exchange ActiveSync, который используется в качестве посредника между Microsoft Exchange Server 2010 и Exchange Server 2007.

Instance

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory

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

InternalAuthenticationMethods

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр определяет методы проверки подлинности, поддерживаемые сервером, на котором находится виртуальный каталог, при запросе доступа изнутри межсетевого экрана сети. Если этот параметр не задан, могут использоваться любые методы проверки подлинности.

InternalUrl

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

System.Uri

Этот параметр используется для возможности HTTP-прокси сервера клиентского доступа. Если для параметра задано значение, сервер клиентского доступа, получающий входящие клиентские подключения, будет перенаправлять запросы по данному URL-адресу. Адрес может указываться в форме URL-адреса полного доменного имени или как внутреннее имя сервера.

MobileClientCertificateAuthorityURL

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

System.String

Этот параметр указывает URL-адрес центра сертификации, используемого мобильным устройством.

MobileClientCertificateProvisioningEnabled

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

System.Boolean

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

MobileClientCertTemplateName

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

System.String

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

Name

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

System.

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

RemoteDocumentsActionForUnknownServers

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

System.Nullable

Этот параметр указывает действие, которое будет выполнено при поступлении через Exchange ActiveSync запроса к Windows SharePoint Services или общему файловому ресурсу Windows. При получении запроса Exchange ActiveSync выполнит поиск запрошенного имени сервера в списках заблокированных и разрешенных имен. Если имя сервера не включено ни в один из этих списков, будет выполнено действие, заданное этим параметром — запрос будет разрешен или заблокирован.

RemoteDocumentsAllowedServers

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

Microsoft.Exchange.Data.MultiValuedProperty

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

RemoteDocumentsBlockedServers

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

Microsoft.Exchange.Data.MultiValuedProperty

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

RemoteDocumentsInternalDomainSuffixList

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

Microsoft.Exchange.Data.MultiValuedProperty

Этот параметр используется в организациях, в сети которых не выполняется WINS. В таких средах можно указать одно или несколько полных доменных имен, которые считаются Exchange ActiveSync внутренними при получении запроса на удаленный доступ к файлам.

WhatIf

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

System.Management.Automation.SwitchParameter

Этот параметр заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью данного параметра можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение для этого параметра не нужно.

WindowsAuthEnabled

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

System.Boolean

Этот параметр указывает, включена ли встроенная проверка подлинности Windows для виртуального каталога Exchange ActiveSync.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Пример

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

Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false