Применимо к: 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 задает идентификатор почтового ящика. Можно использовать следующие значения:
|
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 равен
|
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. Если задано значение
|
EwsBlockList |
Необязательный |
Microsoft.Exchange.Data.MultiValuedProperty |
Параметр EwsBlockList задает приложения (строки
пользовательских агентов), не имеющие доступа к веб-службам
Exchange, если параметр EwsApplicationAccessPolicy равен
|
EwsEnabled |
Необязательный |
System.Boolean |
Параметр EwsEnabled указывает, следует ли включить на глобальном уровне доступ к веб-службам Exchange для пользователя вне зависимости от приложения, делающего запрос. Если параметр EwsEnabled равен |
HasActiveSyncDevicePartnership |
Необязательный |
System.Boolean |
Параметр HasActiveSyncDevicePartnership указывает, имеет ли почтовый ящик связь с мобильным устройством ActiveSync. |
IgnoreDefaultScope |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр IgnoreDefaultScope указывает, что при выполнении команды необходимо игнорировать параметр, определяющий для сеанса командной консоли Exchange область получателя по умолчанию, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Служба каталогов Active Directory, которые на текущий момент не относятся к области действия по умолчанию. Для параметра IgnoreDefaultScope действуют следующие ограничения.
|
ImapEnabled |
Необязательный |
System.Boolean |
Параметр ImapEnabled указывает, включен ли протокол IMAP4 для этого почтового ящика. |
ImapEnableExactRFC822Size |
Необязательный |
System.Boolean |
Параметр ImapEnableExactRFC822Size указывает размер кэша IMAP4. |
ImapMessagesRetrievalMimeFormat |
Необязательный |
Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat |
Параметр ImapMessagesRetrievalMimeFormat указывает формат сообщений, получаемых с сервера. Возможные значения:
|
ImapSuppressReadReceipt |
Необязательный |
System.Boolean |
Параметр IMAPSuppressReadReceipt указывает, следует ли
останавливать отправку дублирующихся уведомлений о прочтении
отправителям IMAP4, использующим в своей почтовой программе 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 указывает формат сообщений, получаемых с сервера. Возможные значения:
|
PopSuppressReadReceipt |
Необязательный |
System.Boolean |
Параметр PopSuppressReadReceipt указывает, следует ли
останавливать отправку дублирующихся уведомлений о прочтении
отправителям POP3, использующим в своей почтовой программе 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 |