Get-CalendarDiagnosticLog

참조

모듈:: ExchangePowerShell

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

이 cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 사용할 수 있지만 온-프레미스 Exchange에서만 작동합니다. 클라우드 기반 서비스에서 대신 Get-CalendarDiagnosticObjects cmdlet을 사용합니다.

Get-CalendarDiagnosticLog cmdlet을 사용하여 일정 로그 범위를 수집합니다. 일정 진단 로그는 사서함의 모든 일정 항목 및 모임 요청을 추적합니다. 이 정보를 사용하여 사서함에서 발생하는 일정 문제를 해결할 수 있습니다.

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

Syntax

Get-CalendarDiagnosticLog
   [-Identity] <MailboxIdParameter>
   -MeetingID <String>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-LogLocation <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-CalendarDiagnosticLog
   [-Identity] <MailboxIdParameter>
   -Subject <String>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-LogLocation <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-CalendarDiagnosticLog
   [-Identity] <MailboxIdParameter>
   -LogLocation <String>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-EndDate <ExDateTime>]
   [-EntryId <String>]
   [-ExactMatch <Boolean>]
   [-ItemClass <String[]>]
   [-ItemIds <String[]>]
   [-Latest]
   [-MeetingID <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [-StartDate <ExDateTime>]
   [-Subject <String>]
   [<CommonParameters>]

Description

이 cmdlet의 출력에는 다음 정보가 포함됩니다.

IsFileLink: LogLocation 매개 변수를 사용하여 일정 항목을 .msg 파일로 내보낼지 여부를 나타냅니다. 값은 True 또는 False입니다.
ID: 일정 항목이 있는 사서함을 식별합니다. 예제 값은 excallog://laura@contoso.com/?id=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAAAP입니다.
LogDate: 일정 항목이 기록된 날짜-시간입니다.
NormalizedSubject: 일정 항목의 제목 필드입니다.
CleanGlobalObjectId: 일정 항목의 수명 동안 일정한 식별자입니다. 예를 들어 0400000008200E00074C5B7101A82E00800000000B0225ABF0710C801000000000000000100000005B27C05AA7C4646B0835D5EB4E41C55.

Get-CalendarDiagnosticLog cmdlet을 실행한 후 Get-CalendarDiagnosticAnalysis cmdlet을 사용하여 달력 데이터를 분석할 수 있습니다. 자세한 내용은 Get-CalendarDiagnosticAnalysis를 참조하세요.

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

예제

예 1

Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $true

다음은 주별 개발 모임을 사용하여 섀넌 스틸 사서함의 일정 진단 로그 항목을 검색하는 예제입니다.

예 2

Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2018 6:00:00 AM" -EndDate "6/30/2018 5:00:00 PM"

다음은 Oscar Evans 사서함의 일정 진단 로그 항목을 2018년 6월 1일부터 2018년 6월 30일로 검색하는 예제입니다.

예 3

Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -Latest

다음은 Jasen Kozma 사서함의 최신 일정 항목에 대한 일정 진단 로그 데이터만 검색하고 메시지 제목은 "매주 개발 모임"으로 검색하는 예제입니다.

예 4

Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"

Exchange 2013에서 이 예제에서는 제목에 "예산 모임"이 있는 Jasen Kozma 사서함의 일정 진단 로그에 있는 모든 일정 항목을 지정된 폴더로 내보냅니다.

참고:

이 예제에서 메시지 파일은 C:\My Documents\Calendar Diagnostic Export\jkozma@contoso.com에 기록됩니다.
온-프레미스 Exchange 조직에서는 Get-CalendarDiagnosticAnalysis cmdlet을 사용하여 내보낸 .msg 파일을 분석할 수 있습니다.
LogLocation 매개 변수를 사용할 수 없기 때문에 Exchange 2016 또는 Exchange 2019에서는 이 예제가 작동하지 않습니다.

매개 변수

-Credential

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

자격 증명 매개 변수는 이 명령을 실행하는 데 사용되는 사용자 이름과 암호를 지정합니다. 일반적으로는 필요한 권한이 있는 여러 자격 증명을 제공해야 하는 경우나 스크립트를 사용하는 경우 이 매개 변수를 사용합니다.

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

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

-DomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

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

-EndDate

EndDate 매개 변수는 날짜 범위의 종료 날짜를 지정합니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

Type:	ExDateTime
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, Exchange Online

-EntryId

EntryId 매개 변수는 항목 ID별로 결과를 필터링합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

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

-ExactMatch

ExactMatch 매개 변수는 Subject 매개 변수에 대해 지정한 텍스트 값에 대해 정확한 일치 또는 부분 일치를 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 제목 검색은 정확히 일치하는 항목을 사용하고 사서함의 모든 일정 항목을 검색합니다. 예를 들어 "예산"을 검색하는 경우 검색은 제목에 "예산"이 있지만 "예산"이 아닌 항목을 찾습니다.
$false: 제목 검색은 부분 일치를 사용하고 사서함에서 최대 1000개 일정 항목을 검색합니다. 예를 들어 "예산"을 검색하는 경우 검색은 주제의 아무 곳이나 "예산"과 "예산"이 있는 항목을 찾습니다. 이 값은 기본값입니다.

부분 제목 일치 검색은 관련 일정 항목을 모두 반환하지 않을 수 있습니다. 정확한 제목 일치 검색을 사용하여 보다 정확한 결과를 시도해 보세요.

이 매개 변수는 Subject 매개 변수와 함께만 사용합니다.

MeetingId 매개 변수를 사용하면 이 매개 변수의 값이 무시됩니다.

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

-Identity

Identity 매개 변수는 일정 항목이 포함된 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

이름
별칭
DN(고유 이름)
DN(고유 이름)
Domain\Username
전자 메일 주소
GUID
LegacyExchangeDN
SamAccountName
사용자 ID 또는 UPN(사용자 계정 이름)

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

-ItemClass

ItemClass 매개 변수는 일정 항목의 지정된 MessageClass 속성 값(예: IPM)으로 결과를 필터링합니다. 약속). 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

이 매개 변수는 MeetingID 매개 변수와 함께만 사용할 수 있습니다.

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

-ItemIds

ItemIds 매개 변수는 항목 ID별로 결과를 필터링합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

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

-Latest

최신 스위치는 가장 최근 일정 항목에 대해서만 일정 로그 데이터를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
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, Exchange Online

-LogLocation

참고: 이 매개 변수는 UNC 경로 값을 허용하므로 2022 H1 누적 업데이트 Exchange 2016 및 Exchange 2019에서 제거되었습니다. 이제 이 cmdlet의 사용이 로컬 서버로 제한됩니다.

이 매개 변수는 Exchange 2010 및 Exchange 2013에서만 작동합니다.

LogLocation 매개 변수는 일정 항목을 .msg 파일로 내보낼 위치를 지정합니다. 로컬 경로 또는 UNC 경로(\\Server\Share)를 지정할 수 있습니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

지정한 위치에서 내보낸 일정 항목을 포함하는 지정된 사서함에 대해 하위 폴더가 자동으로 만들어집니다. 예를 들어 섀넌 스틸 사서함에서 일정 항목을 내보내기 위해 "C:\My Documents\Calendar Export" 값을 지정하면 .msg 파일이 실제로 C:\My Documents\Calendar Export\ssteele@contoso.com에 저장됩니다.

온-프레미스 Exchange 조직에서는 Get-CalendarDiagnosticAnalysis cmdlet을 사용하여 내보낸 .msg 파일을 분석할 수 있습니다.

참고: 일정 항목에 제목이 없는 경우 이 매개 변수를 사용하는 명령이 실패할 수 있습니다. 이 매개 변수를 사용할 때 오류가 발생하면 명령을 다시 실행하고 이 매개 변수를 파일로 리디렉션(| Set-Content -Path "C:\My Documents\Calendar Export")으로 바꾸거나 출력을 PowerShell 변수로 대체합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Online

-MeetingID

MeetingID 매개 변수는 달력 항목의 전역적으로 고유한 식별자를 기준으로 결과를 필터링합니다. 값은 이 cmdlet의 출력 또는 다른 MAPI 검사 도구를 사용하여 사용할 수 있는 달력 항목의 CleanGlobalObjectId 속성입니다. 예제 값은 040000008200E00074C5B7101A82E00800000000B0225ABF0710C8입니다.01000000000000000100000005B27C05AA7C4646B0835D5EB4E41C55. 이 값은 일정 항목의 수명 동안 일정합니다.

이 값을 찾으려면 먼저 Subject, StartDate 및 EndDate 매개 변수를 사용하여 일정 항목을 검색하는 것이 가장 쉽습니다. 원하는 일정 항목을 찾은 후 이후 명령에서 MeetingID 매개 변수에 CleanGlobalObjectId 값을 사용할 수 있습니다.

MeetingID 매개 변수의 값이 우선하기 때문에 Subject 매개 변수와 함께 이 매개 변수를 사용하지 마세요.

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

-ReadFromDomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

ReadFromDomainController 스위치는 사용자 도메인의 도메인 컨트롤러에서 정보를 읽도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

명령: Set-AdServerSettings -ViewEntireForest $true 포리스트에 모든 개체를 포함하려면 ReadFromDomainController 스위치가 필요합니다. 그렇지 않으면 명령은 오래된 정보가 포함된 글로벌 카탈로그를 사용할 수 있습니다. 또한 ReadFromDomainController 스위치를 사용하여 명령의 여러 반복을 실행하여 정보를 가져와야 할 수도 있습니다.

기본적으로 수신자 범위는 Exchange 서버를 호스트하는 도메인으로 설정됩니다.

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

이 매개 변수는 cmdlet에서 반환된 결과 수를 결정합니다. 최대값은 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, Exchange Online

-StartDate

StartDate 매개 변수는 날짜 범위의 시작 날짜를 지정합니다.

Type:	ExDateTime
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, Exchange Online

-Subject

Subject 매개 변수는 제목 필드의 지정된 텍스트로 일정 항목을 식별합니다. 지정한 텍스트 값은 대/소문자를 구분하지 않습니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다. ExactMatch 매개 변수를 사용하여 정확한 일치를 사용할지 여부를 제어할 수 있습니다.

MeetingID 매개 변수의 값이 우선하기 때문에 MeetingID 매개 변수와 함께 이 매개 변수를 사용하지 마세요.

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

입력

Input types

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

출력

Output types

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

Get-CalendarDiagnosticLog

Syntax

Description

예제

예 1

예 2

예 3

예 4

매개 변수

-Credential

-DomainController

-EndDate

-EntryId

-ExactMatch

-Identity

-ItemClass

-ItemIds

-Latest

-LogLocation

-MeetingID

-ReadFromDomainController

-ResultSize

-StartDate

-Subject

입력

출력

피드백

피드백

추가 리소스