Get-ActiveSyncDeviceStatistics
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Командлет Get-ActiveSyncDeviceStatistics позволяет получать список мобильных устройств, настроенных для синхронизации с почтовым ящиком заданного пользователя, и возвращать список статистических данных об этих мобильных устройствах.
Примечание: этот командлет оптимальным образом работает с Exchange 2010. В более поздних версиях Exchange или Exchange Online используйте командлет Get-MobileDeviceStatistics. Если у вас есть скрипты, использующие Get-ActiveSyncDeviceStatistics, обновите их, чтобы использовать Get-MobileDeviceStatistics.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-ActiveSyncDeviceStatistics
[-Identity] <ActiveSyncDeviceIdParameter>
[-DomainController <Fqdn>]
[-GetMailboxLog]
[-NotificationEmailAddresses <MultiValuedProperty>]
[-ShowRecoveryPassword]
[<CommonParameters>]
Get-ActiveSyncDeviceStatistics
-Mailbox <MailboxIdParameter>
[-DomainController <Fqdn>]
[-GetMailboxLog]
[-NotificationEmailAddresses <MultiValuedProperty>]
[-ShowRecoveryPassword]
[<CommonParameters>]
Описание
Командлет Get-ActiveSyncDeviceStatistics возвращает список статистических данных о каждом мобильном устройстве. Кроме того, он позволяет получать журналы и отправлять их получателю для устранения неисправностей.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-ActiveSyncDeviceStatistics -Mailbox TonySmith
В этом примере извлекается статистика для мобильного телефона, настроенного для синхронизации с почтовым ящиком пользователя по имени Алексей Орехов.
Пример 2
$UserList = Get-CASMailbox -Filter "HasActiveSyncDevicePartnership -eq `$true -and -not DisplayName -like 'CAS_{*'"
Get-Mailbox $UserList | foreach {Get-ActiveSyncDeviceStatistics -Mailbox $_}
В этом примере используется командлет Get-CASMailbox, чтобы определить, у кого в организации есть Exchange ActiveSync мобильное устройство. Для каждого мобильного устройства извлекается статистика Exchange ActiveSync устройств.
Примечание. Дополнительные сведения о синтаксисе фильтра OPATH см. в разделе Дополнительные сведения о синтаксисе OPATH.
Пример 3
Get-ActiveSyncDeviceStatistics -Mailbox TonySmith -GetMailboxLog -NotificationEmailAddresses "admin@contoso.com"
В этом примере извлекается статистика для мобильного телефона, настроенного для синхронизации с почтовым ящиком пользователя по имени Алексей Орехов. Он также выводит файл журнала Exchange ActiveSync и отправляет его системному администратору по адресу admin@contoso.com.
Параметры
-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 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Параметр Identity указывает идентификатор устройства пользователя. Если указан параметр Mailbox, параметр Identity недоступен.
Type: | ActiveSyncDeviceIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, 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 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ShowRecoveryPassword
Параметр ShowRecoveryPassword указывает, возвращать ли пароль для восстановления мобильного телефона в качестве отображаемой статистики. Если для параметра установлено значение $true, команда возвращает пароль для восстановления мобильного телефона в качестве отображаемой статистики.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.