Get-CalendarDiagnosticAnalysis
이 cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 사용할 수 있지만 온-프레미스 Exchange에서만 작동합니다.
Get-CalendarDiagnosticAnalysis cmdlet을 사용하면 일정 관련 안정성 문제를 해결할 수 있습니다. 이 cmdlet을 사용하여 일정 진단 로그에 기록된 일정 항목 데이터를 분석할 수 있습니다. Get-CalendarDiagnosticLog cmdlet을 사용하여 이 cmdlet에 일정 항목 데이터를 제공합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Get-CalendarDiagnosticAnalysis
-CalendarLogs <CalendarLog[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>]
Get-CalendarDiagnosticAnalysis
-LogLocation <String[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>]
Description
Calendar 항목의 다음 속성은 cmdlet의 기본 출력에 반환됩니다(DetailLevel 매개 변수가 Basic으로 설정된 경우).
- 로컬 로그 시간
- ItemId
- NormalizedSubject
- StartTime
- EndTime
- CalendarLogTriggerAction
- ClientInfoString
- OriginalLastModifiedTime
- ClientIntent
- CleanGlobalObjectId
- ItemClass
- ParentDisplay
- 기간
- AppointmentRecurring
- SentRepresentingEmailAddress
- SenderEmailAddress
- SentRepresentingDisplayName
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
$logs = Get-CalendarDiagnosticLog -Identity oevans -MeetingID 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000001000000010B0349F6B17454685E17D9F9512E71F
Get-CalendarDiagnosticAnalysis -CalendarLogs $logs -DetailLevel Advanced | Set-Content -Path "C:\My Documents\Oscar Evans Analysis.csv"
이 예제에서는 Oscar Evans의 사서함에서 지정된 일정 항목을 가져오고, 항목을 변수로 저장하고, 항목의 고급 분석을 CSV 파일에 씁니다.
항목의 기본 분석을 위해 DetailLevel 매개 변수를 포함하지 않거나 고급 대신 Basic 값을 사용합니다.
예 2
Get-CalendarDiagnosticAnalysis -LogLocation "C:\My Documents\Exported Calendar Logs\jkozma@contoso.com" -DetailLevel Advanced -OutputAs HTML | Set-Content -Path "C:\My Documents\Jasen Kozma Analysis.html"
Exchange 2013에서 이 예제에서는 LogLocation 매개 변수와 함께 Get-CalendarDiagnosticLog cmdlet을 사용하여 이전에 Jasen Kozma의 사서함에서 내보낸 일정 항목을 분석하고 항목의 고급 분석을 HTML 파일에 씁니다.
참고: LogLocation 매개 변수는 Exchange 2013에서만 사용할 수 있습니다. Exchange 2016 또는 Exchange 2019에서 내보낸 일정 항목의 위치를 지정하려면 예제 3을 참조하세요.
항목의 기본 분석을 위해 DetailLevel 매개 변수를 포함하지 않거나 고급 대신 Basic 값을 사용합니다.
예 3
$calitems = Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Budget Meeting"
ForEach($item in $calitems){$i++; Get-CalendarDiagnosticAnalysis -CalendarLogs $item -OutputAs HTML | Set-Content -Path ("\\FileServer01\Data\Jasen Kozma Analysis{0}.html" -f $i)}
이 예제에서는 Get-CalendarDiagnosticLog cmdlet을 사용하여 Jasen Kozma의 사서함에서 내보낸 일정 항목을 분석하고 UNC 경로를 사용하여 각 항목에 대한 고급 분석을 HTML 파일에 씁니다.
항목의 기본 분석을 위해 DetailLevel 매개 변수를 포함하지 않거나 고급 대신 Basic 값을 사용합니다.
매개 변수
-CalendarLogs
CalendarLogs 매개 변수는 분석할 일정 항목을 지정합니다. Get-CalendarDiagnosticLog cmdlet의 출력을 변수에 저장하고 이 매개 변수 값에 해당 변수를 사용하여 일정 항목을 식별합니다.
예를 들어 섀넌 스틸의 사서함에서 "11월 예산 회의"라는 제목으로 모임을 분석하려면 명령을 $Budget = Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "November Budget Meeting" -ExactMatch
실행한 다음 이 매개 변수의 값을 $Budget
사용합니다.
이 매개 변수에 사용하는 값은 단일 항목을 식별해야 합니다. 여러 항목을 식별하려면 예제 3을 참조하세요.
LogLocation 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
Type: | CalendarLog[] |
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, Exchange Online |
-DetailLevel
DetailLevel 매개 변수는 분석 출력에 사용할 세부 정보 표시 수준을 지정합니다. 유효한 값은 다음과 같습니다.
- 기본: 기본값입니다. 반환되는 일정 항목 속성은 자세한 설명에 나열됩니다.
- 고급: 37개의 추가 일정 항목 속성이 반환됩니다. 자세한 디버깅 정보에만 이 값을 사용해야 합니다.
Type: | AnalysisDetailLevel |
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 |
-GlobalObjectId
GlobalObjectId 매개 변수는 분석할 일정 항목의 ID를 지정합니다. Exchange 2013에서 이 매개 변수를 LogLocation 매개 변수와 함께 사용하여 위치에 내보낸 여러 .msg 파일이 포함된 경우 일정 항목을 지정할 수 있습니다.
모임의 GlobalObjectId 속성은 CleanGlobalObjectId 속성과 동일한 형식을 사용합니다(예: 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000100000010B0349F6B17454685E17D9F9512E71F) 및 두 속성의 값은 같을 가능성이 높습니다. 그러나 GlobalObjectId 값은 여러 일정에서 동일한 모임의 모든 인스턴스에 대해 동일하게 유지되지 않을 수 있습니다(예: 동일한 되풀이 모임의 다른 인스턴스에 초대된 다른 참석자).
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, Exchange Online |
-LogLocation
참고: 이 매개 변수는 UNC 경로 값을 허용하므로 2022 H1 누적 업데이트 Exchange 2016 및 Exchange 2019에서 제거되었습니다. 분석할 일정 항목을 지정하려면 CalendarLogs 매개 변수를 사용합니다.
이 매개 변수는 Exchange 2013에서만 작동합니다.
LogLocation 매개 변수는 분석하려는 내보낸 일정 항목의 위치를 지정합니다. 로컬 경로 또는 UNC 경로(\\Server\Share\User
)를 지정할 수 있습니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
LogLocation 매개 변수와 함께 Get-CalendarDiagnosticLog cmdlet을 사용하여 일정 항목을 .msg 파일로 내보냅니다. 경로에 여러 .msg 파일이 포함된 경우 Get-CalendarDiagnosticAnalysis를 실행할 때 모든 파일이 분석됩니다.
CalendarLogs 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Online |
-OutputAs
OutputAs 매개 변수는 명령의 출력 형식을 지정합니다. 유효한 값은 다음과 같습니다.
- CSV(기본값)
- HTML
- XML
Type: | OutputType |
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 |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.