Get-EXOCasMailbox
Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.
Используйте командлет Get-EXOCasMailbox для просмотра параметров клиентского доступа, настроенных в почтовых ящиках.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-EXOCasMailbox
[[-Identity] <String>]
[-ActiveSyncDebugLogging]
[-ExternalDirectoryObjectId <Guid>]
[-Filter <String>]
[-GetImapProtocolLog]
[-GetPopProtocolLog]
[-IgnoreDefaultScope]
[-OrganizationalUnit <String>]
[-PrimarySmtpAddress <String>]
[-Properties <String[]>]
[-PropertySets <PropertySet[]>]
[-ProtocolSettings]
[-ReadIsOptimizedForAccessibility]
[-ResultSize <Unlimited>]
[-SendLogsTo <String[]>]
[-UserPrincipalName <String>]
[<CommonParameters>] Get-EXOCasMailbox
[-Anr <String>]
[-ActiveSyncDebugLogging]
[-Filter <String>]
[-GetImapProtocolLog]
[-GetPopProtocolLog]
[-IgnoreDefaultScope]
[-OrganizationalUnit <String>]
[-Properties <String[]>]
[-PropertySets <PropertySet[]>]
[-ProtocolSettings]
[-ReadIsOptimizedForAccessibility]
[-ResultSize <Unlimited>]
[-SendLogsTo <String[]>]
[<CommonParameters>] Описание
Этот командлет возвращает различные параметры клиентского доступа для одного или нескольких почтовых ящиков. Эти параметры включают параметры для Outlook в Интернете, Exchange ActiveSync, POP3 и IMAP4.
Примеры
Пример 1
Get-EXOCASMailbox -Identity "JeffHay@contoso.com"В этом примере возвращаются значения следующих параметров клиентского доступа для пользователя с удостоверением Jeffhay@contoso.com:
- ActiveSyncEnabled
- EwsEnabled
- OWAEnabled
- PopEnabled
- ImapEnabled
- MAPIEnabled
- ECPEnabled
Параметры
-ActiveSyncDebugLogging
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Anr
Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:
- CommonName (CN)
- DisplayName
- FirstName
- LastName
- Alias (Псевдоним)
Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity, PrimarySmtpAddress или UserPrincipalName.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ExternalDirectoryObjectId
Параметр ExternalDirectoryObjectId определяет почтовый ящик, который требуется просмотреть с помощью ObjectId в Azure Active Directory.
Этот параметр нельзя использовать с параметрами Anr, Identity, PrimarySmtpAddress или UserPrincipalName.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Filter
Параметр Filter использует синтаксис OPATH для фильтрации результатов по указанным свойствам и значениям. Для критериев поиска используется следующий синтаксис: "Property -ComparisonOperator 'Value'".
- Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например,
$true,$falseили$null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные. - Property — это свойство с поддержкой фильтрации. Дополнительные сведения о фильтруемых свойствах см . в разделах Наборы свойств Get-EXOCasMailbox и Фильтруемые свойства для параметра Filter.
- ComparisonOperator — это оператор сравнения OPATH (например
-eq, для равных и-likeдля сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators. - Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки (
'Value'или'$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо'$User'используйте'$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте500,$true,$false, или$nullвместо них).
Можно связать несколько условий поиска вместе с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".
Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GetImapProtocolLog
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GetPopProtocolLog
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Параметр Identity указывает почтовый ящик, который требуется просмотреть. Для максимальной производительности рекомендуется использовать следующие значения:
- Идентификатор пользователя или имя участника-пользователя
- GUID
В противном случае можно использовать любое другое значение, которое однозначно идентифицирует почтовый ящик. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- LegacyExchangeDN
- SamAccountName
Этот параметр нельзя использовать с параметрами Anr, ExternalDirectoryObjectId, PrimarySmtpAddress или UserPrincipalName.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IgnoreDefaultScope
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-OrganizationalUnit
Параметр OrganizationalUnit фильтрует результаты по расположению объекта в Active Directory. Возвращаются только те объекты, которые существуют в указанном расположении. Допустимые значения для этого параметра — подразделение или домен, который можно отобразить с помощью командлета Get-OrganizationalUnit. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:
- Имя
- Имя
- различающееся имя (DN);
- GUID
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PrimarySmtpAddress
PrimarySmtpAddress определяет почтовый ящик, который нужно просмотреть по основному SMTP-адресу электронной почты (например, navin@contoso.com).
Этот параметр нельзя использовать с параметрами Anr, ExternalDirectoryObjectId, Identity или UserPrincipalName.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Properties
Параметр Properties указывает свойства, возвращаемые в выходных данных этого командлета. Вы можете указать несколько значений, разделив их запятыми.
Дополнительные сведения о доступных свойствах см. в разделе Наборы свойств Get-EXOCasMailbox.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PropertySets
Параметр PropertySets задает логическое группирование свойств, возвращаемых в выходных данных этого командлета. Допустимые значения:
- Минимум (это значение по умолчанию)
- ActiveSync
- Ews
- Imap
- Mapi
- Pop
- ProtocolSettings
- Все
Вы можете указать несколько значений, разделив их запятыми.
Дополнительные сведения о свойствах, включенных в каждый набор свойств, см. в разделе Наборы свойств Get-EXOCasMailbox.
| Type: | PropertySet[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ProtocolSettings
Переключатель ProtocolSettings возвращает имена серверов, порты TCP и методы шифрования для следующих параметров:
- ExternalImapSettings
- InternalImapSettings
- ExternalPopSettings
- InternalPopSettings
- ExternalSmtpSettings
- InternalSmtpSettings
Для этого переключателя не требуется указывать значение.
Чтобы увидеть эти значения, необходимо использовать командлет форматирования. Например, Get-CasMailbox laura@contoso.com -ProtocolSettings | Format-List.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ReadIsOptimizedForAccessibility
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SendLogsTo
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserPrincipalName
Параметр UserPrincipalName определяет почтовый ящик, который нужно просмотреть по имени участника-пользователя (например, navin@contoso.onmicrosoft.com).
Этот параметр нельзя использовать с параметрами Anr, ExternalDirectoryObjectId, Identity или PrimarySmtpAddress.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
Входные данные
Input types
Следующие Get-CasMailbox параметры недоступны или не поддерживаются в Get-EXOCasMailbox:
- IgnoreDefaultScope
- ReadIsOptimizedForAccessibility
- SortBy
Выходные данные
Output types
Следующие свойства удаляются конструктором из выходных данных Get-EXOCasMailbox:
- RunspaceId
- Имя _сервера
- OriginatingServer
- IsValid
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по