Get-QueueDigest
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Get-QueueDigest для просмотра сведений об очередях доставки сообщений на сайтах Active Directory групп доступности баз данных (DAG) или лесах Active Directory в вашей организации.
По умолчанию командлет Get-QueueDigest отображает очереди доставки, содержащие десять или более сообщений, а результаты находятся в возрасте от одной до двух минут. Инструкции по изменению этих значений по умолчанию см. в разделе Настройка Get-QueueDigest.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-QueueDigest
-Dag <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Get-QueueDigest
[-Forest]
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Get-QueueDigest
-Server <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Get-QueueDigest
-Site <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Описание
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-QueueDigest -Forest
В этом примере возвращаются сведения обо всех очередях в лесу Active Directory.
Пример 2
Get-QueueDigest -Dag DAG01
В этом примере показано возвращение сведений обо всех очередях в группе DAG с именем DAG01.
Параметры
-Dag
Параметр Dag фильтрует результаты очередей доставки по группам DAG. Можно указать любое уникальное значение, идентифицирующее группу DAG. Можно указать несколько значений, разделенных запятыми. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Параметр Dag нельзя использовать вместе с параметрами Server, Site или Forest.
Type: | MultiValuedProperty |
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 |
-DetailsLevel
Параметр DetailsLevel указывает уровень детализации при отображении результатов. Допустимые значения этого параметра — None, Normal и Verbose. Normal — значение по умолчанию.
Type: | DetailsLevel |
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 |
-Filter
Параметр Filter указывает одну или несколько очередей с помощью синтаксиса фильтра OPATH. Фильтр OPATH включает имя свойства очереди, за которым следует оператор сравнения и значение (например, "NextHopDomain -eq 'contoso.com'"
). Дополнительные сведения о свойствах фильтруемых очередей и операторах сравнения см. в разделах Свойства очереди в Exchange Server и Поиск очередей и сообщений в очередях в командной консоли Exchange.
Можно указать несколько условий с помощью оператора сравнения и . Значения свойств, не выраженные в виде целого числа, должны заключаться в кавычки (").
Type: | String |
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 |
-Forest
Параметр Лес фильтрует результаты очереди доставки по лесу Active Directory. Значение параметра Forest указывать не нужно.
Переключатель Forest нельзя использовать вместе с параметрами Server, Site или Dag.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GroupBy
Параметр GroupedBy сортирует сообщения в результатах очереди доставки. Допустимые значения:
- DeliveryType
- LastError
- NextHopCategory
- NextHopDomain (это значение по умолчанию)
- NextHopKey
- RiskLevel
- Состояние
- ServerName
- OutboundIPPool
Type: | QueueDigestGroupBy |
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 |
-ResultSize
Параметр ResultSize фильтрует результаты очереди доставки по количеству сообщений в очереди. Допустимым значением для этого параметра является целое число. Значение по умолчанию равно 1000. Например, если указать значение, равное 50, команда отобразит 50 очередей, содержащих наибольшее количество сообщений.
Type: | Unlimited |
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 |
-Server
Параметр Server фильтрует результаты очереди доставки по Exchange Server. Можно указать любое уникальное значение, идентифицирующее сервер. Можно указать несколько значений, разделенных запятыми. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Параметр Server нельзя использовать вместе с параметрами Dag, Site или Forest.
Type: | MultiValuedProperty |
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 |
-Site
Параметр Site фильтрует результаты очереди доставки по сайту Active Directory. Можно указать любое уникальное значение, идентифицирующее сайт. Можно указать несколько сайтов, разделенных запятыми.
Параметр Site нельзя использовать вместе с параметрами Server, Dag или Forest.
Type: | MultiValuedProperty |
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 |
-Timeout
Параметр Timeout задает количество секунд, в течение которых ожидается выполнение операции, прежде чем она будет блокирована по времени. Значение по умолчанию: 10 секунд.
Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.
Type: | EnhancedTimeSpan |
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 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.