Командлет Set-ActiveSyncVirtualDirectory позволяет настроить параметры Microsoft ActiveSync для указанного виртуального каталога.
Синтаксис
Set-ActiveSyncVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] |
Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] |
Параметры
Параметр | Обязательность | Тип | Описание |
---|---|---|---|
Идентификатор |
Обязательность |
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. Настройка по умолчанию —
|
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. |
ExternalAuthenticationMethods |
Дополнительно |
Microsoft.Exchange.Data.MultiValuedProperty |
Этот параметр определяет методы проверки подлинности, поддерживаемые сервером, на котором находится виртуальный каталог, при запросе доступа снаружи межсетевого экрана сети. Если этот параметр не задан, могут использоваться любые методы проверки подлинности. |
ExternalUrl |
Дополнительно |
System.Uri |
Этот параметр задает URL-адрес, используемый для подключения к виртуальному каталогу через межсетевой экран. |
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 |
Этот параметр указывает имя шаблона для клиентского сертификата. |
Имя |
Дополнительно |
System.String |
Этот параметр указывает имя виртуального каталога 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 внутренними при получении запроса на удаленный доступ к файлам. |
Подробное описание
Командлет Set-ActiveSyncVirtualDirectory позволяет настраивать различные параметры в виртуальном каталоге, который используется для Exchange ActiveSync.
Для выполнения командлета Set-ActiveSyncVirtualDirectory используемой учетной записи необходимо делегировать следующее:
- роль администратора сервера Exchange Server и членство в
локальной группе администраторов на целевом сервере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Пример
В следующем примере кода отключается обычная проверка подлинности для виртуального каталога Exchange ActiveSync на сервере с именем Contoso.
Копировать код | |
---|---|
Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false |