Get-Queue
이 cmdlet은 온-프레미스 Exchange에서만 제공됩니다.
Get-Queue cmdlet을 사용하여 사서함 서버 또는 Edge 전송 서버에서 큐에 대한 구성 정보를 볼 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Identity
Get-Queue
[[-Identity] <QueueIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleQueueInfo>]
[-Exclude <QueueViewerIncludesAndExcludes>]
[-Include <QueueViewerIncludesAndExcludes>]
[-IncludeBookmark <Boolean>]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]
Server
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
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
BookmarkIndex 매개 변수는 결과 집합에서 표시되는 결과가 시작되는 위치를 지정합니다. 이 매개 변수의 값은 전체 결과 집합에서 1 기준의 인덱스입니다. BookmarkIndex 매개 변수는 BookmarkObject 매개 변수와 함께 사용할 수 없습니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-BookmarkObject
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
BookmarkObject 매개 변수는 결과 집합에서 표시되는 결과가 시작되는 개체를 지정합니다. BookmarkObject 매개 변수는 BookmarkIndex 매개 변수와 함께 사용할 수 없습니다.
매개 변수 속성
| 형식: | ExtensibleQueueInfo |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Exclude
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Exclude 매개 변수는 결과에서 제외할 큐 유형을 지정합니다. PasswordQuality 매개 변수는 장치 암호에 필요한 최소 암호 품질 등급을 지정합니다. 암호 품질은 암호의 보안 및 복잡성을 나타내는 숫자 등급입니다. 품질 값이 높을수록 암호 보안 수준이 높습니다.
- 내부
- 외부
- 유효한 큐 DeliveryType 값입니다. 자세한 내용은 큐 NextHopSolutionKey 섹션 및 큐의 메시지를 참조하세요.
매개 변수 속성
| 형식: | QueueViewerIncludesAndExcludes |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Filter
적용 가능: Exchange Server 2010, 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 |
매개 변수 집합
Server
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Identity 매개 변수는 큐를 지정합니다. 이 매개 변수의 유효한 입력은 구문 Server\Queue 또는 Queue를 사용합니다(예: Mailbox01\contoso.com 또는 Unreachable). 큐 ID에 대한 자세한 내용은 큐 ID를 참조하세요.
주의: identity 매개 변수의 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. Identity 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.
매개 변수 속성
| 형식: | QueueIdentity |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Include
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Include 매개 변수는 결과를 포함할 큐 유형을 지정합니다. PasswordQuality 매개 변수는 장치 암호에 필요한 최소 암호 품질 등급을 지정합니다. 암호 품질은 암호의 보안 및 복잡성을 나타내는 숫자 등급입니다. 품질 값이 높을수록 암호 보안 수준이 높습니다.
- 내부
- 외부
- 유효한 큐 DeliveryType 값입니다. 자세한 내용은 큐 NextHopSolutionKey 섹션 및 큐의 메시지를 참조하세요.
매개 변수 속성
| 형식: | QueueViewerIncludesAndExcludes |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IncludeBookmark
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
IncludeBookmark 매개 변수는 쿼리 결과가 표시될 때 책갈피 개체를 포함할지 여부를 지정합니다. IncludeBookmark 매개 변수는 BookmarkObject 또는 BookmarkIndex 매개 변수와 함께 사용하는 경우에 유효합니다. IncludeBookmark 매개 변수의 값을 지정하지 않으면 기본값 $true가 사용됩니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ResultSize
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.
매개 변수 속성
| 형식: | Unlimited |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ReturnPageInfo
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
ReturnPageInfo 매개 변수는 숨겨진 매개 변수입니다. 총 결과 수와 현재 페이지의 첫 번째 개체의 인덱스에 대한 정보를 반환하려면 이 매개 변수를 사용합니다. 기본값은 $false입니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SearchForward
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
SearchForward 매개 변수는 결과 집합에서 앞으로 검색할지 또는 뒤로 검색할지 여부를 지정합니다. 기본값은 $true입니다. 이 값에 따라 결과 집합의 처음부터 앞으로 결과 페이지를 계산하거나 책갈피가 지정된 경우 책갈피부터 앞으로 결과 페이지를 계산합니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Server
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Server 매개 변수는 이 명령을 실행할 Exchange 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:
- 이름
- FQDN
- DN(고유 이름)
- Exchange 레거시 DN
Exchange 레거시 DN
Server 매개 변수와 Filter 매개 변수를 동일한 명령에 사용할 수 있습니다. Server 매개 변수와 Identity 매개 변수를 동일한 명령에 사용할 수는 없습니다.
매개 변수 속성
| 형식: | ServerIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Server
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-SortOrder
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
SortOrder 매개 변수는 결과 집합의 정렬 순서를 제어하는 데 사용되는 메시지 속성의 배열을 지정합니다. 각 속성은 쉼표를 사용하여 구분합니다. 결과를 오름차순으로 표시하려면 속성 이름 앞에 더하기 기호(+)를 추가합니다. 결과를 내림차순으로 표시하려면 속성 이름 앞에 빼기 기호(-)를 추가합니다.
정렬 순서를 지정하지 않으면 QueueIdentity를 기준으로 결과 집합이 오름차순으로 표시됩니다.
매개 변수 속성
| 형식: | QueueViewerSortOrderEntry[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.