Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-22

Командлет Set-CASMailbox используется для установки атрибутов, связанных с клиентским доступом к службам Microsoft Exchange ActiveSync, Microsoft Office Outlook Web App, POP3 и IMAP4 для указанного пользователя.

Синтаксис

set-CASMailbox -Identity <MailboxIdParameter> [-ActiveSyncAllowedDeviceIDs <MultiValuedProperty>] [-ActiveSyncBlockedDeviceIDs <MultiValuedProperty>] [-ActiveSyncDebugLogging <$true | $false>] [-ActiveSyncEnabled <$true | $false>] [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ECPEnabled <$true | $false>] [-EmailAddresses <ProxyAddressCollection>] [-EmwsEnabled <$true | $false>] [-EwsAllowEntourage <$true | $false>] [-EwsAllowList <MultiValuedProperty>] [-EwsAllowMacOutlook <$true | $false>] [-EwsAllowOutlook <$true | $false>] [-EwsApplicationAccessPolicy <EnforceAllowList | EnforceBlockList>] [-EwsBlockList <MultiValuedProperty>] [-EwsEnabled <$true | $false>] [-HasActiveSyncDevicePartnership <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ImapEnabled <$true | $false>] [-ImapEnableExactRFC822Size <$true | $false>] [-ImapMessagesRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-ImapSuppressReadReceipt <$true | $false>] [-ImapUseProtocolDefaults <$true | $false>] [-MAPIBlockOutlookNonCachedMode <$true | $false>] [-MAPIBlockOutlookRpcHttp <$true | $false>] [-MAPIBlockOutlookVersions <String>] [-MAPIEnabled <$true | $false>] [-Name <String>] [-OWAEnabled <$true | $false>] [-OwaMailboxPolicy <MailboxPolicyIdParameter>] [-PopEnabled <$true | $false>] [-PopEnableExactRFC822Size <$true | $false>] [-PopMessagesRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-PopSuppressReadReceipt <$true | $false>] [-PopUseProtocolDefaults <$true | $false>] [-PrimarySmtpAddress <SmtpAddress>] [-SamAccountName <String>] [-ShowGalAsDefaultView <$true | $false>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity задает идентификатор почтового ящика. Можно использовать следующие значения:

  • GUID

  • Различающееся имя (DN)

  • Имя участника-пользователя (UPN)

  • SMTP-адрес

  • Псевдоним

ActiveSyncAllowedDeviceIDs

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ActiveSyncAllowedDeviceIDs принимает список идентификаторов устройств, которым разрешено синхронизироваться с этим почтовым ящиком.

ActiveSyncBlockedDeviceIDs

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр ActiveSyncBlockedDeviceIDs принимает список идентификаторов устройств, которым не разрешено синхронизироваться с этим почтовым ящиком.

ActiveSyncDebugLogging

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

System.Boolean

Параметр ActiveSyncDebugLogging указывает, включено ли ведение журнала в целях отладки Exchange ActiveSync.

ActiveSyncEnabled

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

System.Boolean

Параметр ActiveSyncEnabled указывает, включено ли Exchange ActiveSync.

ActiveSyncMailboxPolicy

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

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Параметр ActiveSyncMailboxPolicy указывает имя политики почтовых ящиков Exchange ActiveSync для этого почтового ящика.

Confirm

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

System.Management.Automation.SwitchParameter

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

DisplayName

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

System.String

Параметр DisplayName указывает отображаемое имя для почтового ящика.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает имя FQDN контроллера домена, который записывает это изменение конфигурации в Служба каталогов Active Directory.

ECPEnabled

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

System.Boolean

Параметр ECPEnabled включает веб-интерфейс управления на этом сервере клиентского доступа.

EmailAddresses

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

Microsoft.Exchange.Data.ProxyAddressCollection

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

EmwsEnabled

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

System.Boolean

Параметр EmwsEnabled указывает, включена ли веб-служба управления Exchange на этом сервере клиентского доступа.

EwsAllowEntourage

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

System.Boolean

Параметр EwsAllowEntourage указывает, следует ли включить для приложения Entourage 2008 для Mac, Web Services Edition пользовательский доступ к веб-службам Exchange. (Поскольку приложение Entourage 2008 полностью основывается на веб-службах Exchange, этот параметр позволяет включать и отключать Entourage 2008.)

EwsAllowList

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр EwsAllowList задает приложения (строки пользовательских агентов), имеющие доступ к веб-службам Exchange, если параметр EwsApplicationAccessPolicy равен EnforceAllowList.

EwsAllowMacOutlook

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

System.Boolean

Параметр EwsAllowMacOutlook указывает, следует ли включить доступ Microsoft Outlook для Mac 2011 (вскоре выйдет бета-версия) к веб-службам Exchange для пользователя. (Поскольку приложение Outlook для Mac 2011 полностью основывается на веб-службах Exchange, этот параметр позволяет включать и отключать Outlook для Mac 2011.)

EwsAllowOutlook

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

System.Boolean

Параметр EwsAllowOutlook позволяет включить или отключить доступ Microsoft Office Outlook 2007 к веб-службам Exchange для пользователя. Приложение Outlook использует веб-службы Exchange для работы со сведениями о доступности и присутствии, а также для общего доступа к календарю.

EwsApplicationAccessPolicy

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

Microsoft.Exchange.Data.Directory.EwsApplicationAccessPolicy

Параметр EwsApplicationAccessPolicy указывает, какие приложения, отличные от Entourage, Outlook для Mac 2011 и Outlook, имеют доступ к веб-службам Exchange. Если задано значение EnforceAllowList, доступ к веб-службам Exchange будут иметь только приложения, указанные в параметре EwsAllowList. Если задано значение EnforceBlockList, то доступ к веб-службам Exchange будут иметь все приложения за исключением тех, что указаны в параметре EwsBlockList.

EwsBlockList

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

Microsoft.Exchange.Data.MultiValuedProperty

Параметр EwsBlockList задает приложения (строки пользовательских агентов), не имеющие доступа к веб-службам Exchange, если параметр EwsApplicationAccessPolicy равен EnforceBlockList.

EwsEnabled

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

System.Boolean

Параметр EwsEnabled указывает, следует ли включить на глобальном уровне доступ к веб-службам Exchange для пользователя вне зависимости от приложения, делающего запрос.

Если параметр EwsEnabled равен $false, доступ к веб-службам Exchange закрывается вне зависимости от значения параметра EwsAllowEntourage. Другими словами, чтобы параметр EwsAllowEntourage имел смысл, сначала следует включить веб-службы Exchange, а для этого нужно присвоить параметру EwsEnabled значение $true.

HasActiveSyncDevicePartnership

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

System.Boolean

Параметр HasActiveSyncDevicePartnership указывает, имеет ли почтовый ящик связь с мобильным устройством ActiveSync.

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации (например, с помощью псевдонима или идентификатора GUID) не допускаются.

ImapEnabled

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

System.Boolean

Параметр ImapEnabled указывает, включен ли протокол IMAP4 для этого почтового ящика.

ImapEnableExactRFC822Size

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

System.Boolean

Параметр ImapEnableExactRFC822Size указывает размер кэша IMAP4.

ImapMessagesRetrievalMimeFormat

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Параметр ImapMessagesRetrievalMimeFormat указывает формат сообщений, получаемых с сервера. Возможные значения:

  • 0:TextOnly

  • 1:HtmlOnly

  • 2:HtmlAndTextAlternative

  • 3:TextEnrichedOnly

  • 4:TextEnrichedAndTextAlternative

  • 5:BestBodyFormat

  • 6:Tnef

ImapSuppressReadReceipt

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

System.Boolean

Параметр IMAPSuppressReadReceipt указывает, следует ли останавливать отправку дублирующихся уведомлений о прочтении отправителям IMAP4, использующим в своей почтовой программе IMAP4 параметр «отправлять уведомления о прочтении отправляемых сообщений». По умолчанию для этого параметра установлено значение $false. По умолчанию отправители IMAP4, использующие параметр «отправлять уведомления о прочтении отправляемых сообщений», получают уведомления о прочтении в следующих условиях:

  • Когда отправленные ими сообщения загружаются получателем.

  • Когда получатель открывает сообщение.

Допустимые значения этого параметра:

  • $false   Уведомление о прочтении отправляется пользователям IMAP4 при каждой загрузке сообщения получателем. Уведомление о прочтении также отправляется пользователям IMAP4 при открытии сообщения.

  • $true   Уведомления о прочтении отправляются пользователям IMAP4, использующим в своей почтовой программе параметр «отправлять уведомления о прочтении отправляемых сообщений», только при открытии сообщения получателем.

ImapUseProtocolDefaults

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

System.Boolean

Параметр ImapUseProtocolDefaults указывает, следует ли использовать значения по умолчанию для протокола IMAP4.

MAPIBlockOutlookNonCachedMode

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

System.Boolean

Параметр MAPIBlockOutlookNonCachedMode указывает, может ли приложение Microsoft Outlook использоваться в интерактивном режиме.

MAPIBlockOutlookRpcHttp

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

System.Boolean

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

MAPIBlockOutlookVersions

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

System.String

Параметр MAPIBlockOutlookVersions указывает, блокируются ли определенные версии Outlook.

MAPIEnabled

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

System.Boolean

Параметр MAPIEnabled указывает, включен ли протокол IMAP4 для почтового ящика.

Name

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

System.String

Параметр Name указывает имя почтового ящика.

OWAEnabled

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

System.Boolean

Параметр OWAEnabled включает приложение Outlook Web App.

OwaMailboxPolicy

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

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Параметр OwaMailboxPolicy определяет активную политику почтовых ящиков Outlook Web App.

PopEnabled

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

System.Boolean

Параметр PopEnabled указывает, включен ли протокол POP3 для этого почтового ящика.

PopEnableExactRFC822Size

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

System.Boolean

Параметр PopEnableExactRFC822Size указывает размер кэша POP3.

PopMessagesRetrievalMimeFormat

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

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Параметр PopMessagesRetrievalMimeFormat указывает формат сообщений, получаемых с сервера. Возможные значения:

  • 0:TextOnly

  • 1:HtmlOnly

  • 2:HtmlAndTextAlternative

  • 3:TextEnrichedOnly

  • 4:TextEnrichedAndTextAlternative

  • 5:BestBodyFormat

  • 6:Tnef

PopSuppressReadReceipt

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

System.Boolean

Параметр PopSuppressReadReceipt указывает, следует ли останавливать отправку дублирующихся уведомлений о прочтении отправителям POP3, использующим в своей почтовой программе POP3 параметр «отправлять уведомления о прочтении отправляемых сообщений». По умолчанию для этого параметра установлено значение $false. По умолчанию отправители POP3, использующие параметр «отправлять уведомления о прочтении отправляемых сообщений», получают уведомления о прочтении в следующих условиях:

  • Когда отправленные ими сообщения загружаются получателем.

  • Когда получатель открывает сообщение.

Допустимые значения и описания этого параметра:

  • $false   Уведомление о прочтении отправляется пользователям POP3 при каждой загрузке сообщения получателем. Уведомление о прочтении также отправляется пользователям POP3 при открытии сообщения.

  • $true   Уведомления о прочтении отправляются пользователям POP3, использующим в своей почтовой программе параметр «отправлять уведомления о прочтении отправляемых сообщений», только при открытии сообщения получателем.

PopUseProtocolDefaults

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

System.Boolean

Параметр PopUseProtocolDefaults указывает, следует ли использовать значения по умолчанию для протокола POP3.

PrimarySmtpAddress

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

Microsoft.Exchange.Data.SmtpAddress

Параметр PrimarySmtpAddress указывает основной SMTP-адрес, связанный с почтовым ящиком.

SamAccountName

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

System.String

Параметр SamAccountName указывает имя учетной записи безопасности.

ShowGalAsDefaultView

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

System.Boolean

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Командлет Set-CASMailbox единовременно может работать только с одним почтовым ящиком. С помощью этого командлета можно настроить свойства Outlook Web App, Exchange ActiveSync, POP3 и IMAP4. С помощью одной инструкции можно настроить одно или несколько свойств.

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Параметры пользователя клиентского доступа» в разделе Разрешения клиентского доступа.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Примеры

ПРИМЕР 1

В этом примере для пользователя adam@contoso.com включается приложение Outlook Web App, а также протокол POP3.

Скопировать код
Set-CASMailbox -Identity adam@contoso.com -OWAEnabled:$true -POPEnabled:$true

ПРИМЕР 2

В этом примере для пользователя adam@contoso.com включается ведение журнала Exchange ActiveSync, блокируется функция Outlook Anywhere, а также задается политика почтовых ящиков Exchange ActiveSync.

Скопировать код
Set-CASMailbox -Identity adam@contoso.com -ActiveSyncDebugLogging:$true -ActiveSyncMailboxPolicy "Management" -MAPIBlockOutlookRpcHttp:$true

ПРИМЕР 3

В этом примере для пользователя tony@contoso.com устанавливается отображаемое имя, а также включается доступ MAPI.

Скопировать код
Set-CASMailbox -Identity tony@contoso.com -DisplayName "Tony Smith" -MAPIEnabled:$true