Get-ConnectionByClientTypeReport

Этот командлет доступен только в облачной службе.

Этот командлет устарел в январе 2018 г. Сведения о доступных отчетах-аналогах Microsoft Graph в Microsoft 365 см. в статье Работа с отчетами об использовании Microsoft 365 в Microsoft Graph.

Командлет Get-ConnectionByClientTypeReport используется для просмотра сводки различных типов клиентов, которые подключаются ко всем почтовым ящикам в организации. Типы клиентов указывают на различные протоколы, например Outlook в Интернете, MAPI, POP3, IMAP4, Exchange ActiveSync и веб-службы Exchange.

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

Синтаксис

Get-ConnectionByClientTypeReport
   [-EndDate <DateTime>]
   [-ReportType <ReportType>]
   [-ResultSize <Unlimited>]
   [-StartDate <DateTime>]
   [<CommonParameters>]

Описание

Примечание. Сведения о подключении клиента, возвращаемые этим командлетом, имеют 7-дневную задержку. Например, если вы выполните командлет 18 июня 2018 г., вы не сможете получить сведения о подключениях к почтовым ящикам в период с 13 июня 2018 г. по 15 июня 2018 г. Чтобы получить сведения о подключении для этого диапазона дат, необходимо выполнить командлет 22 июня 2018 г. или более поздней версии.

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

Примеры

Пример 1

Get-ConnectionByClientTypeReport -StartDate 06/13/2015 -EndDate 06/15/2015

В этом примере показано получение сводки по различным типам клиентов, которые использовались для подключения ко всем почтовым ящикам в период с 13 июня 2015 года по 15 июня 2015 года.

Параметры

-EndDate

Параметр EndDate указывает дату окончания из диапазона дат.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ReportType

Параметр ReportType сводит данные в отчет с учетом указанного значения. Допустимые значения этого параметра: Daily, Weekly, Monthly и Yearly. Значение параметра ReportType нужно использовать вместе с допустимыми значениями параметров StartDate и EndDate для просмотра данных за указанный период времени.

Type:ReportType
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

-StartDate

Параметр StartDate указывает дату начала из диапазона дат.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

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

Input types

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

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

Output types

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