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


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

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