다음을 통해 공유


Get-QueueDigest

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

Get-QueueDigest cmdlet을 사용하여 DAG(데이터베이스 가용성 그룹) Active Directory 사이트 또는 조직의 Active Directory 포리스트에서 메시지 배달 큐에 대한 정보를 볼 수 있습니다.

기본적으로 Get-QueueDigest cmdlet은 메시지가 10개 이상 포함된 배달 큐를 표시하고 1~2분 후에 결과를 반환합니다. 이러한 기본값을 변경하는 방법에 대한 지침은 Get-QueueDigest 구성을 참조하세요.

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

Syntax

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

Description

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Get-QueueDigest -Forest

다음은 Active Directory 포리스트의 모든 큐에 대한 정보를 반환하는 예제입니다.

예 2

Get-QueueDigest -Dag DAG01

이 예에서는 DAG01이라는 DAG에 있는 모든 큐에 대한 정보를 반환합니다.

매개 변수

-Dag

Dag 매개 변수는 DAG를 기준으로 배달 큐 결과를 필터링합니다. DAG를 고유하게 식별하는 값을 지정할 수 있습니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Dag 매개 변수는 Server, Site 또는 Forest 매개 변수와 함께 사용할 수 없습니다.

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

-DetailsLevel

DetailsLevel 매개 변수는 결과에 표시할 세부 정보의 수준을 지정합니다. 이 매개 변수의 올바른 값은 None, Normal 및 Verbose입니다. 기본값은 Normal입니다.

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

-Forest

포리스트 스위치는 Active Directory 포리스트별로 배달 큐 결과를 필터링합니다. Forest 스위치를 사용하여 값을 지정할 필요가 없습니다.

Forest 스위치는 Server, Site 또는 Dag 매개 변수와 함께 사용할 수 없습니다.

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

-GroupBy

GroupedBy 매개 변수는 배달 큐 결과에 있는 메시지를 정렬합니다. 유효한 값은 다음과 같습니다.

  • DeliveryType
  • LastError
  • NextHopCategory
  • NextHopDomain(기본값)
  • NextHopKey
  • RiskLevel
  • 상태
  • ServerName
  • OutboundIPPool
Type:QueueDigestGroupBy
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

-ResultSize

ResultSize 매개 변수는 큐의 메시지 수를 기준으로 배달 큐 결과를 필터링합니다. 이 매개 변수의 올바른 입력은 정수입니다. 기본값은 1000입니다. 예를 들어 값으로 50을 지정하면 가장 많은 메시지를 포함하는 큐가 50개 표시됩니다.

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

-Server

Server 매개 변수는 Exchange 서버별로 배달 큐 결과를 필터링합니다. 서버를 고유하게 식별하는 값을 지정할 수 있습니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Server 매개 변수는 Dag, Site 또는 Forest 매개 변수와 함께 사용할 수 없습니다.

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

-Site

사이트 매개 변수는 Active Directory 사이트별로 배달 큐 결과를 필터링합니다. 사이트를 고유하게 식별하는 값을 지정할 수 있습니다. 여러 개의 사이트를 쉼표로 구분하여 지정할 수 있습니다.

Site 매개 변수는 Server, Dag 또는 Forest 매개 변수와 함께 사용할 수 없습니다.

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

-Timeout

Timeout 매개 변수는 작업 시간이 초과하기 전의 시간(초)을 지정합니다. 기본값은 10초입니다.

값을 지정하려면 시간 범위로 입력합니다. dd.hh:mm:ss 여기서 dd = days, hh = hours, mm = minutes 및 ss = seconds.

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

입력

Input types

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

출력

Output types

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