Get-MobileDeviceStatistics
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Командлет Get-MobileDeviceStatistics позволяет получать список мобильных устройств, настроенных для синхронизации с почтовым ящиком заданного пользователя, и возвращать список статистических данных об этих мобильных устройствах.
Примечание. В Exchange Online PowerShell вместо этого рекомендуется использовать командлет Get-EXOMobileDeviceStatistics. Дополнительные сведения см. в статье Connect to Exchange Online PowerShell.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-MobileDeviceStatistics
[-Identity] <MobileDeviceIdParameter>
[-ActiveSync]
[-DomainController <Fqdn>]
[-GetMailboxLog]
[-NotificationEmailAddresses <MultiValuedProperty>]
[-OWAforDevices]
[-ShowRecoveryPassword]
[-RestApi]
[-UniversalOutlook]
[<CommonParameters>]
Get-MobileDeviceStatistics
-Mailbox <MailboxIdParameter>
[-ActiveSync]
[-DomainController <Fqdn>]
[-GetMailboxLog]
[-NotificationEmailAddresses <MultiValuedProperty>]
[-OWAforDevices]
[-ShowRecoveryPassword]
[-RestApi]
[-UniversalOutlook]
[<CommonParameters>]
Описание
Командлет Get-MobileDeviceStatistics возвращает список статистических данных о каждом мобильном устройстве. Кроме того, он позволяет получать журналы и отправлять их получателю для устранения неисправностей.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-MobileDeviceStatistics -Identity TonySmith\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac
В этом примере извлекается статистика для указанного мобильного телефона.
Пример 2
$UserList = Get-CASMailbox -ResultSize unlimited -Filter "HasActiveSyncDevicePartnership -eq `$true -and -not DisplayName -like 'CAS_{*'"
$UserList | foreach {Get-MobileDeviceStatistics -Mailbox $_.Identity}
В этом примере используется командлет Get-CASMailbox, чтобы определить, у кого в организации есть Exchange ActiveSync мобильное устройство. Для каждого мобильного устройства извлекается статистика Exchange ActiveSync устройств.
Примечание. Дополнительные сведения о синтаксисе фильтра OPATH см. в разделе Дополнительные сведения о синтаксисе OPATH.
Пример 3
Get-MobileDeviceStatistics -Mailbox "Tony Smith" -GetMailboxLog -NotificationEmailAddresses "admin@contoso.com"
В этом примере извлекается статистика для мобильного телефона, настроенного для синхронизации с почтовым ящиком Тони Смита. Он также выводит файл журнала и отправляет его системному администратору по адресу admin@contoso.com.
Параметры
-ActiveSync
Переключатель ActiveSync фильтрует результаты по Exchange ActiveSync устройствам. Указывать значение для этого параметра необязательно.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GetMailboxLog
Параметр GetMailboxLog указывает, следует ли отправлять статистику мобильного устройства на адреса электронной почты, указанные параметром NotificationEmailAddresses. Указывать значение для этого параметра необязательно.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Параметр Identity указывает мобильное устройство, которое требуется просмотреть. Можно использовать следующие значения, однозначно определяющие мобильное устройство:
- Удостоверение (
<Mailbox Name>\ExchangeActiveSyncDevices\<MobileDeviceObjectName>
например,CarlosM\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac
) - различающееся имя (DN);
- GUID (то же, что и ExchangeObjectId)
Этот параметр нельзя использовать с параметром Mailbox.
Type: | MobileDeviceIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Mailbox
Параметр Mailbox фильтрует результаты по почтовому ящику пользователя, связанному с мобильным устройством. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
Имя базы данных
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-NotificationEmailAddresses
Параметр NotificationEmailAddresses указывает разделенный запятыми список адресов электронной почты для получения статистики мобильных устройств при использовании параметра GetMailboxLog.
Этот параметр имеет смысл, только если вы также используете параметр GetMailboxLog в той же команде.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-OWAforDevices
Переключатель OWAforDevices фильтрует результаты по устройствам, на которых включена Outlook в Интернете для устройств. Для этого переключателя не требуется указывать значение.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RestApi
Переключатель RestApi фильтрует результаты по устройствам REST API. Указывать значение для этого параметра необязательно.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ShowRecoveryPassword
Параметр ShowRecoveryPassword указывает, следует ли возвращать пароль восстановления для мобильного устройства в качестве одного из отображаемых статистических данных. Указывать значение для этого параметра необязательно.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-UniversalOutlook
Переключатель UniversalOutlook фильтрует результаты по устройствам Почты и Календаря. Указывать значение для этого параметра необязательно.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.