Поделиться через

Get-ActiveSyncDeviceClass

Модуль:
Exchange PowerShell

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

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

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

Синтаксис

Default (По умолчанию) 

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

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

Параметры

-DomainController

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Свойства параметров

Тип:Fqdn
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

(All)
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Filter

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online

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

  • Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
  • Property — это свойство с поддержкой фильтрации.
  • 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.

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

  • DeviceModel
  • DeviceType
  • LastUpdateTime

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

(All)
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online

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

  • имя;
  • различающееся имя (DN);
  • GUID

Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.

Свойства параметров

Тип:ActiveSyncDeviceClassIdParameter
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

(All)
Позиция:1
Обязательный:False
Ценность воронки продаж:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SortBy

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online

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

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

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

  • DeviceModel
  • DeviceType
  • LastUpdateTime

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддержка подстановочных знаков:False
Не показывайте:False

Наборы параметров

(All)
Позиция:Named
Обязательный:False
Ценность воронки продаж:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

Входы

Input types

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

Выходы

Output types

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