Get-AipServiceUserLog
보호 사용자 로그를 Azure Information Protection 로컬 스토리지로 다운로드합니다.
구문
Get-AipServiceUserLog
-Path <String>
[-FromDate <DateTime>]
[-ToDate <DateTime>]
[-ForDate <DateTime>]
[-Force]
[-NumberOfThreads <Int32>]
[<CommonParameters>] Description
Get-AipServiceUserLog cmdlet은 보호 사용자 로그를 로컬 스토리지에 다운로드합니다. 로그 항목을 다운로드하려면 특정 날짜 또는 날짜 범위를 지정해야 합니다.
이러한 사용자 로그를 얻으려면 PowerShell을 사용해야 합니다. 관리 포털을 사용하여 이 작업을 수행할 수 없습니다.
이 명령을 실행하고 DateTime 개체에 대한 날짜만 지정하면 시간은 현지 시간으로 00:00:00으로 간주된 다음 UTC로 변환됩니다.
날짜가 있는 시간(예: -ForDate '2/1/2016 15:00:00')을 지정하면 해당 날짜와 시간이 UTC로 변환됩니다. 그런 다음 Get-AipServiceUserLog 명령은 해당 UTC 기간에 대한 로그를 가져옵니다. 사용 현황 로그는 "date" 필드 이름에 이전 날짜 값(UTC 시간)이 포함된 경우에만 사용할 수 있습니다. 현재 날짜의 사용 현황 로그를 사용할 수 없습니다.
현지 시간에 필요한 변환을 수용하기 위해 DateTime 값을 변경해야 하는 방법에 대한 예제를 참조하세요.
보호 사용 현황 로깅 및 단계별 예제에 대한 자세한 내용은 Azure In formation Protection에서 보호 사용 현황 로깅 및 분석을 참조하세요.
예제
예제 1: 날짜 범위에 대한 사용자 로그 가져오기
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '12/12/2015' -ToDate '12/15/2015' -NumberOfThreads 10이 명령은 2015년 12월 12일과 2015년 12월 15일(UTC 시간) 사이에 생성된 사용자 로그를 C:\Logs 폴더에 다운로드합니다.
명령은 10개의 스레드를 사용하여 로그를 다운로드합니다.
예제 2: 날짜에 대한 사용자 로그 가져오기
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '12/5/2015'이 명령은 2015년 12월 5일(UTC 시간)에 대한 사용자 로그를 C:\Logs 폴더에 다운로드합니다.
예제 3: UTC +오프셋 시간 변환을 고려하여 날짜에 대한 사용자 로그 가져오기
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '2/2/2016 12:00:00'이 명령은 사용자 로그를 C:\Logs 폴더로 다운로드하기 전에 현지 시간에서 UTC +오프셋 시간 변환을 고려해야 하는 방법을 보여 줍니다.
뉴질랜드에 있습니다. 즉, 컴퓨터의 현지 시간이 UTC+12이며 UTC가 아닌 현지 시간으로 2016년 2월 2일 로그를 다운로드하려고 합니다. 날짜가 포함된 12:00:00 시간을 지정하지 않은 경우 로그에는 2016년 2월 2일의 처음 12시간(전날의 마지막 12시간)에 대한 데이터만 포함됩니다.
예제 4: UTC 오프셋 시간 변환을 고려하여 날짜 범위에 대한 사용자 로그 가져오기
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '2/1/2016 18:00:00' -ToDate '2/9/15/2016 18:00:00'이 명령은 사용자 로그를 C:\Logs 폴더로 다운로드하기 전에 현지 시간에서 UTC 오프셋 시간 변환을 고려해야 하는 방법을 보여 줍니다.
미국 휴스턴에 있습니다. 즉, 컴퓨터의 현지 시간이 UTC-6이며 UTC가 아닌 현지 시간으로 2016년 2월 2일부터 2016년 2월 9일까지 로그를 다운로드하려고 합니다.
이전 날짜와 시간을 18:00:00으로 지정하지 않은 경우 로그에 2016년 2월 2일의 처음 6시간(종료 날짜에 대한 추가 6시간)에 대한 데이터가 누락됩니다.
매개 변수
-Force
이 cmdlet은 확인 메시지를 표시하지 않고 동일한 날짜 또는 날짜 범위에 대한 기존 로그 파일을 덮어씁니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForDate
로그 파일의 날짜(및 필요에 따라 시간)를 DateTime 개체로 지정합니다.
FromDate 매개 변수를 사용하지 않는 경우 이 매개 변수를 사용합니다.
DateTime 개체를 가져오려면 Get-Date cmdlet을 사용합니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FromDate
로그 파일의 시작 날짜(및 필요에 따라 시간)를 DateTime 개체로 지정합니다.
ForDate 매개 변수를 사용하지 않는 경우 이 매개 변수를 사용합니다.
이 매개 변수를 지정하지만 ToDate를 지정하지 않으면 종료 날짜는 명령을 실행하는 날짜입니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NumberOfThreads
로그를 다운로드하는 데 사용할 스레드 수를 지정합니다.
이 매개 변수에 허용되는 값은 1-32입니다.
기본값은 3입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Path
로그를 저장할 폴더의 기존 경로를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ToDate
로그 파일의 중지 날짜(및 필요에 따라 시간)를 DateTime 개체로 지정합니다.
필요에 따라 FromDate 매개 변수를 사용하여 특정 날짜 범위를 지정할 때 이 매개 변수를 지정합니다. FromDate 매개 변수를 사용할 때 이 매개 변수를 지정하지 않으면 종료 날짜는 명령을 실행하는 날짜입니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |