Get-Queue

Синтаксис

Get-Queue
   [[-Identity] <QueueIdentity>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleQueueInfo>]
   [-Exclude <QueueViewerIncludesAndExcludes>]
   [-Include <QueueViewerIncludesAndExcludes>]
   [-IncludeBookmark <Boolean>]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]
Get-Queue
   [-Server <ServerIdParameter>]
   [-Filter <String>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleQueueInfo>]
   [-Exclude <QueueViewerIncludesAndExcludes>]
   [-Include <QueueViewerIncludesAndExcludes>]
   [-IncludeBookmark <Boolean>]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1

Get-Queue | Format-List

В этом примере отображаются подробные сведения обо всех очередях на сервере почтовых ящиков, на котором выполнена команда.

Пример 2

Get-Queue -Filter "MessageCount -gt 100"

В этом примере перечисляются очереди, содержащие больше 100 сообщений.

Пример 3

Get-Queue Server1\contoso.com | Format-List

В этом примере отображаются подробные сведения об отдельной очереди, существующей на сервере почтовых ящиков Server1.

Пример 4

Get-Queue -Exclude Internal

В этом примере перечисляются только внутренние очереди.

Параметры

-— BookmarkIndex

Параметр BookmarkIndex задает позицию в наборе результатов, с которой начинаются отображаемые результаты. Значение этого параметра — индекс с отсчетом от единицы в общем наборе результатов. Параметр BookmarkIndex невозможно использовать вместе с параметром BookmarkObject.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Exclude

Параметр Exclude указывает типы очередей, которые необходимо исключить из результатов. Допустимые значения этого параметра:

  • Внутренний
  • Внешний
  • Допустимое значение DeliveryType очереди. Дополнительные сведения см в разделе NextHopSolutionKey в очередях и сообщениях в очередях.
Type:QueueViewerIncludesAndExcludes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Filter

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

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Include

Параметр Include указывает типы очередей, которые необходимо включить в результаты. Допустимые значения этого параметра:

  • Внутренний
  • Внешний
  • Допустимое значение DeliveryType очереди. Дополнительные сведения см в разделе NextHopSolutionKey в очередях и сообщениях в очередях.
Type:QueueViewerIncludesAndExcludes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— SortOrder

Параметр SortOrder указывает массив свойств сообщений, которые используются для управления порядком сортировки набора результатов. Каждое свойство отделяется запятой. Для отображения результатов в порядке возрастания вставьте символ "плюс" (+) в начале имени свойства. Для отображения результатов в порядке убывания вставьте символ "минус" (-) в начале имени свойства.

Если порядок сортировки не указан, результирующий набор отображается в порядке возрастания QueueIdentity.

Type:QueueViewerSortOrderEntry[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Букмаркобжект

Параметр BookmarkObject задает в наборе результатов объект, с которого начинаются отображаемые результаты. Параметр BookmarkObject невозможно использовать вместе с параметром BookmarkIndex.

Type:ExtensibleQueueInfo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Инклудебукмарк

Параметр IncludeBookmark указывает, используется ли объект закладок при отображении результатов запроса. Параметр IncludeBookmark допустимо использовать только с параметром BookmarkObject или BookmarkIndex. Если значение для параметра IncludeBookmark не указано, используется значение по умолчанию — $true.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Ретурнпажеинфо

ReturnPageInfo — это скрытый параметр. Он служит для получения сведений об общем количестве результатов и индексе первого объекта текущей страницы. Значение по умолчанию — $false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Сеарчфорвард

Параметр SearchForward указывает, должен ли поиск в наборе результатов выполняться в прямом или обратном порядке. Значение по умолчанию — $true. Если указано это значение, при возврате страницы результатов используется прямой порядок поиска от начала набора результатов или от закладки, если она указана.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

Параметр Identity определяет очередь. Допустимые входные данные для этого параметра используют \ очередь или очередь сервера синтаксиса, например Mailbox01 \ contoso.com или недоступна. Сведения об удостоверении очереди можно найти в статье Identity Queue.

Type:QueueIdentity
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ResultSize

Параметр ResultSize указывает максимальное количество возвращаемых результатов. Чтобы вернуть все запросы, отвечающие запросу, установите для этого параметра значение "без ограничений". Значение по умолчанию: 1000.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Server

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

  • Имя.
  • полное доменное имя;
  • различающееся имя (DN);
  • Устаревшее различающееся имя Exchange

Устаревшее различающееся имя Exchange

Параметр Server можно использовать вместе с параметром Filter в одной команде. Параметр Server невозможно использовать вместе с параметром Identity в одной команде.

Type:ServerIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

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

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