Get-CalendarDiagnosticObjects

  • 참조
모듈:
ExchangePowerShell
적용 대상:
Exchange Online

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Get-CalendarDiagnosticObjects cmdlet을 사용하여 일정 로그 범위를 수집합니다. 일정 진단 로그는 각 사서함에 대한 중요한 일정 관련 이벤트 데이터를 추적하고 사서함에서 발생하는 일정 문제를 해결하는 데 사용할 수 있습니다. 로그는 모든 일정 항목 및 모임 메시지를 추적합니다.

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

Syntax

Get-CalendarDiagnosticObjects
   [-Identity] <UnifiedGroupOrUserMailboxIdParameter>
   [-AutoRequeryOnMeetingId <Boolean>]
   [-ConfigurationName <String>]
   [-CustomPropertyNames <String[]>]
   [-EndDate <ExDateTime>]
   [-EntryId <String>]
   [-EwsId <String>]
   [-ExactMatch <Boolean>]
   [-ItemClass <String[]>]
   [-ItemIds <String[]>]
   [-MaxResults <Int32>]
   [-MeetingId <String>]
   [-ODataId <String>]
   [-ResultSize <Unlimited>]
   [-ShouldBindToItem <Boolean>]
   [-ShouldDecodeEnums <Boolean>]
   [-ShouldFetchAttendeeCollection <Boolean>]
   [-ShouldFetchRecurrenceExceptions <Boolean>]
   [-StartDate <ExDateTime>]
   [-Subject <String>]
   [<CommonParameters>]

Description

결과에 반환되는 몇 가지 흥미로운 속성은 다음과 같습니다.

  • AppointmentState: 1 = 약속이 모임이고, 2 = 약속이 수신되었습니다. 4 = 약속이 취소되었으며 8 = 약속이 전달된 약속입니다.
  • CalendarLogTriggerAction: 항목에 대해 수행되는 작업(예: 만들기 또는 업데이트)입니다.
  • ClientInfoString: 변경한 엔터티입니다(예 Client=OWA;<AdditionalDetails>: , Client=WebServices;<AdditionalDetails>;, 또는 Client=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;).
  • MeetingRequestType: 1 = 모임 메시지는 모임 요청, 65536 = 모임 메시지는 기존 모임에 대한 전체 업데이트입니다. 131072 = 모임 메시지는 기존 모임에 대한 정보 업데이트입니다. 262144 = 모임 메시지는 자동 업데이트입니다. 524288 = 업데이트가 만료되었거나 1048576 = 모임 메시지가 대리인에게 전달됩니다. 복사가 정보로 표시됩니다.
  • OriginalLastModifiedTime: 이벤트를 정렬하는 기본 정렬 필드로 사용됩니다.
  • ResponseType: 0 = 이끌이가 응답을 받지 못했습니다. 1 = 모임 이끌이의 복사본, 2 = 미정, 3 = 수락, 4 = 거절, 5 = 참석자가 응답하지 않았습니다.
  • ResponsibleUserName: 변경한 사용자의 LegacyExchangeDN 값(예 /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendant : 또는 /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=696eea97d3c449eab648920d03385efb-admin)입니다.

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

예제

예 1

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

이 예제에서는 제목이 팀 모임과 정확히 일치하는 모든 항목에 대해 Pedro Pizarro의 사서함에서 일정 진단 로그를 검색합니다.

예 2

$A = Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

$A | Select-Object *,@{n='OLMT'; e={[DateTime]::Parse($_.OriginalLastModifiedTime.ToString())}} | sort OLMT | Format-Table OriginalLastModifiedTime,CalendarLogTriggerAction,ItemClass,ClientInfoString

이는 이전 예제와 동일하지만 이제 결과는 마지막으로 수정된 원래 시간을 기준으로 정렬됩니다.

예 3

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -MeetingID 40000008200E00074C5B7101A82E00800000000693ADAA3B5FCD201000000000000000010000000FF760A70460EAA4096B879872DF24F49

다음은 지정된 GOID(전역 개체 ID)를 사용하여 모임에 대한 Pedro Pizarro 사서함의 일정 진단 로그를 검색하는 예제입니다.

예 4

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Lunch" -StartDate 7/1/2018 -EndDate 7/31/2018 | Export-Csv "C:\My Documents\Team Lunch Meeting.csv" -NoTypeInformation

이 예제에서는 2018년 7월에 수정된 Pedro Pizarro 사서함에서 팀 점심이라는 제목의 모임에 대한 진단 정보를 반환하고 결과를 C:\My Documents\Team Lunch Meeting.csv 파일로 내보냅니다.

매개 변수

-AutoRequeryOnMeetingId

{{ Fill AutoRequeryOnMeetingId description }}

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

-ConfigurationName

{{ Fill ConfigurationName Description }}

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

-CustomPropertyNames

CustomPropertyNames 매개 변수는 결과에 지정된 일정 항목 사용자 지정 속성을 반환합니다. 유효한 값은 Exchange Online PowerShell의 CustomPropertyNames 매개 변수에 대한 값을 참조하세요.

쉼표로 구분하여 여러 값을 지정할 수 있습니다.

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

-EndDate

EndDate 매개 변수는 OriginalLastModifiedTime 속성에 대한 날짜 범위의 종료 날짜를 지정합니다(모임이 마지막으로 수정된 경우 생성되지 않음).

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 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 Online

-EntryId

EntryID 매개 변수는 MAPI 속성 PR_ENTRYID 해당하는 지정된 EntryID 속성 값으로 결과를 필터링합니다.

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

-EwsId

{{ Fill EwsId description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 Online

-Identity

Identity 매개 변수는 일정을 보려는 사서함 또는 Microsoft 365 그룹을 지정합니다. 사서함 또는 Microsoft 365 그룹을 고유하게 식별하는 값을 사용할 수 있습니다. 예:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • Domain\Username
  • 전자 메일 주소
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 사용자 ID 또는 UPN(사용자 계정 이름)
Type:UnifiedGroupOrUserMailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-ItemClass

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 Online

-MaxResults

{{ Fill MaxResults description }}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MeetingId

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

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

-ODataId

{{ 채우기 ODataId Description }}

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

-ResultSize

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

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldBindToItem

ShouldBindToItem 매개 변수는 큰 스트리밍 가능한 속성 값(예: AppointmentRecurrenceBlob)을 잘라할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 큰 스트리밍 가능한 속성의 값은 잘리지 않으므로 전체 값이 반환됩니다.
  • $false: 큰 스트리밍 가능한 속성의 값이 잘립니다. 이 값은 기본값입니다.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldDecodeEnums

{{ Fill ShouldDecodeEnums Description }}

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

-ShouldFetchAttendeeCollection

{{ Fill ShouldFetchAttendeeCollection Description }}

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

-ShouldFetchRecurrenceExceptions

ShouldFetchRecurrenceExceptions 매개 변수는 되풀이 모임에 예외를 포함할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 되풀이 모임에 대한 예외를 포함합니다. 이 값을 사용하는 경우 ItemIds 매개 변수도 사용해야 합니다.
  • $false: 되풀이 모임에 예외를 포함하지 마세요. 이 값은 기본값입니다.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

StartDate 매개 변수는 OriginalLastModifiedTime 속성에 대한 날짜 범위의 시작 날짜를 지정합니다(모임이 마지막으로 수정된 경우 생성되지 않음).

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 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 Online

-Subject

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

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