Get-Queue

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Командлет Get-Queue используется для просмотра сведений о конфигурации для очередей на серверах почтовых ящиков или пограничных транспортных серверах.

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

Синтаксис

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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BookmarkObject

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

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

-Exclude

Параметр Exclude указывает типы очередей, которые необходимо исключить из результатов. Параметр PasswordQuality указывает минимальную оценку качества для паролей устройства. Качество пароля — это числовая шкала, указывающая уровень безопасности и сложности пароля. Более высокое качество означает более надежный пароль.

Внутренний
Внешний
Допустимое значение DeliveryType очереди. Дополнительные сведения см. в разделе NextHopSolutionKey статьи Очереди и сообщения в очередях.

Type:	QueueViewerIncludesAndExcludes
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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Параметр Identity определяет очередь. Чтобы указать этот параметр, используйте синтаксис Server\Queue или Queue, например Mailbox01\contoso.com или Unreachable. Дополнительные сведения об идентификаторе очереди см. в разделе Удостоверение очереди.

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

-Include

Параметр Include указывает типы очередей, которые необходимо включить в результаты. Параметр PasswordQuality указывает минимальную оценку качества для паролей устройства. Качество пароля — это числовая шкала, указывающая уровень безопасности и сложности пароля. Более высокое качество означает более надежный пароль.

Внутренний
Внешний
Допустимое значение DeliveryType очереди. Дополнительные сведения см. в разделе NextHopSolutionKey статьи Очереди и сообщения в очередях.

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

-IncludeBookmark

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

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

-ResultSize

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

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

-ReturnPageInfo

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

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

-SearchForward

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SortOrder

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

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

Type:	QueueViewerSortOrderEntry[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Input types

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

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

Output types

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