Get-ActiveSyncDeviceClass

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Get-ActiveSyncDeviceClass для получения списка устройств ActiveSync, подключенных к Организации. Командлет возвращает информацию о типе и модели мобильных устройств.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-ActiveSyncDeviceClass
   [[-Identity] <ActiveSyncDeviceClassIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-SortBy <String>]
   [<CommonParameters>]

Описание

Этот командлет можно использовать для просмотра списка мобильных телефонов и устройств с делением по типам. Например, можно возвратить список всех мобильных устройств Android в организации или всех устройств Windows Phone в Организации.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-ActiveSyncDeviceClass -Filter "DeviceType -eq 'WP'"

В примере возвращается список всех телефонов Windows Phone.

Пример 2

Get-ActiveSyncDeviceClass | group-object -Property DeviceType

В этом примере перечисляются все типы устройств в организации, а также приводится число устройств каждого типа.

Параметры

-— Filter

Параметр Filter использует синтаксис OPath для фильтрации результатов по указанным свойствам и значениям. В условиях поиска используется синтаксис "Property -ComparisonOperator 'Value'" .

  • Заключите весь фильтр OPath в двойные кавычки "". Если фильтр содержит системные значения (например,, $true $false или $null ), используйте одинарные кавычки ' '. Несмотря на то, что этот параметр является строкой (не системным блоком), можно также использовать фигурные скобки {}, только если фильтр не содержит переменных.
  • Свойство является фильтруемым свойством.
  • Компарисоноператор — это оператор сравнения OPath (например -eq , для Equals и -like для сравнения строк). Дополнительные сведения об операторах сравнения можно найти в статье about_Comparison_Operators.
  • Value — это искомое значение свойства. Заключите текстовые значения и переменные в одинарные кавычки ( 'Value' или '$Variable' ). Если значение переменной содержит одиночные кавычки, необходимо определить (ESC) одинарные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' , используйте '$($User -Replace "'","''")' . Не включайте целые числа и системные значения (например,,, 500 , $true $false или $null ).

Вы можете связать несколько критериев поиска вместе, используя логические операторы -and и -or . Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3" .

Подробные сведения о фильтрах OPath в Exchange приведены в статье Дополнительные сведения о синтаксисе OPATH.

Можно выполнять фильтрацию по следующим свойствам:

  • DeviceModel
  • DeviceType
  • LastUpdateTime
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-— SortBy

Параметр SortBy указывает свойство, по которому необходимо сортировать результаты. Вы можете выполнять сортировку не более, чем по одному свойству одновременно. Результаты будут отсортированы в порядке возрастания.

Если представление по умолчанию не включает свойство, по которому выполняется сортировка, можно добавить команду с параметром | Format-Table -Auto Property1,Property2,...PropertyX . для создания представления, которое содержит все свойства, которые вы хотите просмотреть. *В именах свойств поддерживаются подстановочные знаки ().

Можно выполнять сортировку по следующим свойствам:

  • DeviceModel
  • DeviceType
  • LastUpdateTime
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

Параметр Identity указывает класс устройств ActiveSync, который требуется просмотреть. Можно использовать любое значение, однозначно идентифицирующее класс устройств ActiveSync. Пример:

  • имя;
  • различающееся имя (DN);
  • GUID
Type:ActiveSyncDeviceClassIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Входные данные

Типы входных данных, поддерживаемые этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы входных данных" для командлета пустое, этот командлет не поддерживает ввода данных.

Выходные данные

Типы возвращаемых данных, или типы выходных данных, которые поддерживаются этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы выходных данных" пустое, командлет не возвращает данные.