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 구문을 참조하십시오.

구문

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+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAP입니다.
LogDate: 일정 항목이 기록된 날짜-시간입니다.
NormalizedSubject: 일정 항목의 제목 필드입니다.
CleanGlobalObjectId: 일정 항목의 수명 동안 일정한 식별자입니다. 예를 들어 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55.

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

다음은 주별 개발 모임을 사용하여 Shannon Steele 사서함에 대한 일정 진단 로그 항목을 검색하는 예제입니다.

예 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

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

형식:	PSCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DomainController

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

형식:	Fqdn
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EndDate

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

형식:	ExDateTime
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EntryId

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ExactMatch

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

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

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

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

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Identity

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

형식:	MailboxIdParameter
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ItemClass

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ItemIds

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online

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

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Latest

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-LogLocation

적용 가능: Exchange Server 2010년, Exchange Server 2013, Exchange Online

참고: 이 매개 변수는 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 변수로 대체합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MeetingID

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

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

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ReadFromDomainController

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

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

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResultSize

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

이 매개 변수는 cmdlet에서 반환된 결과 수를 결정합니다. 최대값은 1000입니다.

형식:	Unlimited
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-StartDate

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

형식:	ExDateTime
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Subject

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

Input types

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

출력

Output types

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

다음을 통해 공유

Get-CalendarDiagnosticLog

구문

Description

예제

예 1

예 2

예 3

예 4

매개 변수

-Credential

-DomainController

-EndDate

-EntryId

-ExactMatch

-Identity

-ItemClass

-ItemIds

-Latest

-LogLocation

-MeetingID

-ReadFromDomainController

-ResultSize

-StartDate

-Subject

입력

출력

피드백