Get-SafeLinksAggregateReport
이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.
Get-SafeLinksAggregateReport cmdlet을 사용하여 지난 90일 동안 안전한 링크 결과에 대한 일반 정보를 반환합니다. 어제는 지정할 수 있는 가장 최근 날짜입니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Get-SafeLinksAggregateReport
[-Action <MultiValuedProperty>]
[-AppNameList <MultiValuedProperty>]
[-EndDate <System.DateTime>]
[-StartDate <System.DateTime>]
[-SummarizeBy <String>]
[<CommonParameters>] Description
참고: 날짜 범위를 지정하지 않고 Get-SafeLinksAggregateReport 실행하는 경우 명령은 지정되지 않은 오류를 반환합니다.
안전한 링크는 전자 메일 메시지의 링크를 확인하여 악성 웹 사이트로 이어지는지 확인하는 Office 365용 Microsoft Defender 기능입니다. 메시지에서 링크를 클릭하면 URL이 일시적으로 다시 작성되고 알려진 악성 웹 사이트 목록과 비교해서 확인됩니다.
cmdlet은 지정한 보고 기간에 대한 다음 정보를 반환합니다.
- 작업
- 앱
- MessageCount
- RecipientCount
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-SafeLinksAggregateReport -StartDate 06-01-2020 -EndDate 06-10-2020 -SummarizeBy App -AppNameList "Email Client","Teams"이 예제에서는 지정된 날짜 범위에 대해 Email 클라이언트 및 Teams 결과로 요약된 결과를 반환합니다.
매개 변수
-Action
Action 매개 변수는 작업별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.
- 허용됨
- 차단됨
- ClickedDuringScan
- ClickedEvenBlocked
- 검색
- TenantAllowed
- TenantBlocked
- TenantBlockedAndClickedThrough
쉼표로 구분하여 여러 값을 지정할 수 있습니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AppNameList
AppNameList 매개 변수는 링크가 발견된 앱으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.
- Email 클라이언트
- OfficeDocs
- Teams
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EndDate
EndDate 매개 변수는 날짜 범위의 종료 날짜를 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다.
어제는 지정할 수 있는 가장 최근 날짜입니다. 90일보다 오래된 날짜는 지정할 수 없습니다.
| Type: | System.DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-StartDate
StartDate 매개 변수는 날짜 범위의 시작 날짜를 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다.
어제는 지정할 수 있는 가장 최근 날짜입니다. 90일보다 오래된 날짜는 지정할 수 없습니다.
| Type: | System.DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SummarizeBy
SummarizeBy 매개 변수는 지정한 값에 따라 합계를 반환합니다. 보고서에서 이 매개 변수가 허용하는 값을 사용하여 데이터를 필터링하는 경우 SummarizeBy 매개 변수를 사용하여 해당 값에 따라 결과를 요약할 수 있습니다. 보고서에 반환되는 행 수를 줄이려면 SummarizeBy 매개 변수를 사용합니다. 요약하면 보고서를 위해 검색되는 데이터 양이 감소하며 보고서가 더 빨리 제공됩니다. 예를 들어 보고서의 개별 행에서 Action 또는 AppNameList의 특정 값의 각 인스턴스를 보는 대신 SummarizeBy 매개 변수를 사용하여 보고서의 한 행에서 해당 특정 Action 또는 App의 총 인스턴스 수를 확인할 수 있습니다.
이 cmdlet의 경우 유효한 값은 다음과 같습니다.
- 작업: Action 매개 변수에 지정된 값만 반환됩니다.
- 앱: AppNameList 매개 변수에 지정된 값만 반환됩니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |