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 |
Этот параметр указывает, следует ли сообщать пользователю об элементах, которые не удается синхронизировать. При значении |
BasicAuthEnabled |
Необязательный |
System.Boolean |
Этот параметр включает и отключает обычную проверку подлинности. Значение по умолчанию — |
ClientCertAuth |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes |
Этот параметр указывает состояние проверки подлинности сертификата клиента. По умолчанию проверка подлинности сертификата клиента отключена. По умолчанию значение этого параметра — |
CompressionEnabled |
Необязательный |
System.Boolean |
Данный параметр представлен целым числом, с помощью которого задается степень сжатия указанного виртуального каталога Exchange ActiveSync. Значение по умолчанию — |
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