Get-Queue

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

이 cmdlet은 온-프레미스 Exchange에서만 제공됩니다.

Get-Queue cmdlet을 사용하여 사서함 서버 또는 Edge 전송 서버에서 큐에 대한 구성 정보를 볼 수 있습니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

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>]

Description

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 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 매개 변수는 결과 집합에서 표시되는 결과가 시작되는 위치를 지정합니다. 이 매개 변수의 값은 전체 결과 집합에서 1 기준의 인덱스입니다. 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). 큐 ID에 대한 자세한 내용은 큐 ID를 참조하세요.

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를 사용합니다. 기본값은 1,000입니다.

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 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:

이름
FQDN
DN(고유 이름)
Exchange 레거시 DN

Exchange 레거시 DN

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

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

출력

Output types

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

다음을 통해 공유