다음을 통해 공유

Get-SafeLinksDetailReport

모듈:
ExchangePowerShell
적용 대상:
Exchange Online

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

Get-SafeLinksDetailReport cmdlet을 사용하여 지난 7일 동안의 안전한 링크 결과에 대한 자세한 정보를 반환합니다. 어제는 지정할 수 있는 가장 최근 날짜입니다.

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

구문

Get-SafeLinksDetailReport
   [-Action <MultiValuedProperty>]
   [-AppNameList <MultiValuedProperty>]
   [-Domain <MultiValuedProperty>]
   [-EndDate <System.DateTime>]
   [-Page <Int32>]
   [-PageSize <Int32>]
   [-RecipientAddress <MultiValuedProperty>]
   [-StartDate <System.DateTime>]
   [<CommonParameters>]

Description

참고: 날짜 범위를 지정하지 않고 Get-SafeLinksDetailReport 실행하는 경우 명령은 지정되지 않은 오류를 반환합니다.

안전한 링크는 전자 메일 메시지의 링크를 확인하여 악성 웹 사이트로 이어지는지 확인하는 Office 365용 Microsoft Defender 기능입니다. 메시지에서 링크를 클릭하면 URL이 일시적으로 다시 작성되고 알려진 악성 웹 사이트 목록과 비교해서 확인됩니다.

이 cmdlet은 다음 정보를 반환합니다.

  • ClickTime
  • NetworkMessageId
  • ClientMessageId
  • SenderAddress
  • RecipientAddress
  • URL
  • UrlDomain
  • 작업
  • AppName
  • SourceId
  • 조직
  • DetectedBy(Office 365용 Microsoft Defender 안전한 링크)
  • UrlType(현재 비어 있음)
  • 플래그 (0: 허용 1: 차단 2: ClickedEvenBlocked 3: ClickedDuringScan)

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

예제

예 1

Get-SafeLinksDetailReport -StartDate 06-07-2020 -EndDate 06-10-2020 -Action Allowed,Blocked -AppNameList "Email Client","Teams" -Domain google.com,teams.com -RecipientAddress faith@contoso.com,chris@contoso.com

이 예제에서는 다음 정보로 결과를 필터링합니다.

  • 날짜 범위: 2020년 6월 7일~2020년 6월 10일
  • 작업: 허용 및 차단됨
  • AppNameList: Email 클라이언트 및 Teams
  • URL 도메인: google.com 및 teams.com
  • 받는 사람 전자 메일 주소: faith@contoso.com 및 chris@contoso.com

매개 변수

-Action

적용 가능: Exchange Online

Action 매개 변수는 작업별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

  • 허용됨: "양수" 판결로 인해 URL이 허용되었습니다.
  • 차단됨: "잘못된" 판결로 인해 URL이 차단되었습니다.
  • ClickedDuringScan: 사용자가 URL 확인을 건너뛰고 안전한 링크 검사를 완료하기 전에 대상 URL로 진행했습니다.
  • ClickedEvenBlocked: 클릭 시 사용자가 URL에 액세스하지 못하도록 차단되었습니다.
  • 검사: URL이 검사되고 있습니다.
  • TenantAllowed: 테넌트 허용/차단 목록의 URL 허용 항목입니다.
  • TenantBlocked: 테넌트 허용/차단 목록의 URL 블록 항목입니다.
  • TenantBlockedAndClickedThrough: 테넌트 허용/차단 목록의 블록 항목으로 인해 URL이 차단되었고 사용자가 블록 페이지를 클릭하여 URL에 액세스했습니다.

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

참고: 이 매개 변수의 값은 대/소문자를 구분합니다. 작업에 대해 반환된 데이터가 없음은 작업이 발생하지 않았음을 의미합니다.

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

-AppNameList

적용 가능: Exchange Online

AppNameList 매개 변수는 링크가 발견된 앱으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

  • Email 클라이언트
  • OfficeDocs
  • Teams

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

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

-Domain

적용 가능: Exchange Online

도메인 매개 변수는 URL의 도메인별로 결과를 필터링합니다.

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

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

-EndDate

적용 가능: Exchange Online

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

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 2018년 9월 1일을 입력합니다.

어제는 지정할 수 있는 가장 최근 날짜입니다. 7일보다 오래된 날짜는 지정할 수 없습니다.

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

-Page

적용 가능: Exchange Online

Page 매개 변수는 표시할 결과 페이지 수를 지정합니다. 이 매개 변수에는 1에서 1,000 사이의 정수를 입력할 수 있습니다. 기본값은 1입니다.

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

-PageSize

적용 가능: Exchange Online

PageSize 매개 변수는 페이지당 최대 항목 수를 지정합니다. 이 매개 변수에는 1에서 5,000 사이의 정수를 입력할 수 있습니다. 기본값은 1,000입니다.

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

-RecipientAddress

적용 가능: Exchange Online

RecipientAddress 매개 변수는 받는 사람의 전자 메일 주소별로 결과를 필터링합니다.

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

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

-StartDate

적용 가능: Exchange Online

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

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 2018년 9월 1일을 입력합니다.

어제는 지정할 수 있는 가장 최근 날짜입니다. 7일보다 오래된 날짜는 지정할 수 없습니다.

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