Get-QueueDigest

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

Используйте командлет Get-QueueDigest для просмотра сведений об очередях доставки сообщений на сайтах Active Directory групп доступности баз данных (DAG) или лесах Active Directory в вашей организации.

По умолчанию командлет Get-QueueDigest отображает очереди доставки, содержащие десять или более сообщений, а результаты находятся в возрасте от одной до двух минут. Инструкции по изменению этих значений по умолчанию см. в разделе Настройка Get-QueueDigest.

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

Синтаксис

Dag

Get-QueueDigest
    -Dag <MultiValuedProperty>
    [-DetailsLevel <DetailsLevel>]
    [-Filter <String>]
    [-GroupBy <QueueDigestGroupBy>]
    [-ResultSize <Unlimited>]
    [-Timeout <EnhancedTimeSpan>]
    [<CommonParameters>]

Forest

Get-QueueDigest
    [-Forest]
    [-DetailsLevel <DetailsLevel>]
    [-Filter <String>]
    [-GroupBy <QueueDigestGroupBy>]
    [-ResultSize <Unlimited>]
    [-Timeout <EnhancedTimeSpan>]
    [<CommonParameters>]

Server

Get-QueueDigest
    -Server <MultiValuedProperty>
    [-DetailsLevel <DetailsLevel>]
    [-Filter <String>]
    [-GroupBy <QueueDigestGroupBy>]
    [-ResultSize <Unlimited>]
    [-Timeout <EnhancedTimeSpan>]
    [<CommonParameters>]

Site

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

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

Параметр Dag фильтрует результаты очередей доставки по группам DAG. Можно указать любое уникальное значение, идентифицирующее группу DAG. Можно указать несколько значений, разделенных запятыми. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Параметр Dag нельзя использовать вместе с параметрами Server, Site или Forest.

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

Dag
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DetailsLevel

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

Параметр DetailsLevel указывает уровень детализации при отображении результатов. Допустимые значения этого параметра — None, Normal и Verbose. Normal — значение по умолчанию.

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

Тип:DetailsLevel
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Filter

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

Параметр Filter указывает одну или несколько очередей с помощью синтаксиса фильтра OPATH. Фильтр OPATH включает имя свойства очереди, за которым следует оператор сравнения и значение (например, "NextHopDomain -eq 'contoso.com'"). Дополнительные сведения о свойствах фильтруемых очередей и операторах сравнения см. в разделах Свойства очереди в Exchange Server и Поиск очередей и сообщений в очередях в командной консоли Exchange.

Можно указать несколько условий с помощью оператора сравнения и . Значения свойств, не выраженные в виде целого числа, должны заключаться в кавычки (").

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

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Forest

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

Параметр Лес фильтрует результаты очереди доставки по лесу Active Directory. Значение параметра Forest указывать не нужно.

Переключатель Forest нельзя использовать вместе с параметрами Server, Site или Dag.

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

Forest
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GroupBy

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

Параметр GroupedBy сортирует сообщения в результатах очереди доставки. Допустимые значения:

  • DeliveryType
  • LastError
  • NextHopCategory
  • NextHopDomain (это значение по умолчанию)
  • NextHopKey
  • RiskLevel
  • Состояние
  • ServerName
  • OutboundIPPool

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

Тип:QueueDigestGroupBy
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ResultSize

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

Параметр ResultSize фильтрует результаты очереди доставки по количеству сообщений в очереди. Допустимым значением для этого параметра является целое число. Значение по умолчанию равно 1000. Например, если указать значение, равное 50, команда отобразит 50 очередей, содержащих наибольшее количество сообщений.

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

Тип:Unlimited
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Server

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

Параметр Server фильтрует результаты очереди доставки по Exchange Server. Можно указать любое уникальное значение, идентифицирующее сервер. Можно указать несколько значений, разделенных запятыми. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Параметр Server нельзя использовать вместе с параметрами Dag, Site или Forest.

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

Server
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Site

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

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

Параметр Site нельзя использовать вместе с параметрами Server, Dag или Forest.

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

Site
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Timeout

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

Параметр Timeout задает количество секунд, в течение которых ожидается выполнение операции, прежде чем она будет блокирована по времени. Значение по умолчанию: 10 секунд.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

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

Тип:EnhancedTimeSpan
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

CommonParameters

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

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

Input types

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

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

Output types

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