Get-QuarantineMessage

구문

Details

Get-QuarantineMessage
    -Identity <QuarantineMessageIdentity>
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-RecipientAddress <String[]>]
    [-SenderAddress <String[]>]
    [-TeamsConversationTypes <Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]>]
    [<CommonParameters>]

Summary

Get-QuarantineMessage

    [-Direction <Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageDirectionEnum>]
    [-Domain <String[]>]
    [-EndExpiresDate <System.DateTime>]
    [-EndReceivedDate <System.DateTime>]
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-IncludeMessagesFromBlockedSenderAddress]
    [-MessageId <String>]
    [-MyItems]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-PolicyName <String>]
    [-PolicyTypes <QuarantinePolicyTypeEnum[]>]
    [-QuarantineTypes <QuarantineMessageTypeEnum[]>]
    [-RecipientAddress <String[]>]
    [-RecipientTag <String[]>]
    [-ReleaseStatus <ReleaseStatus[]>]
    [-Reported <Boolean>]
    [-SenderAddress <String[]>]
    [-StartExpiresDate <System.DateTime>]
    [-StartReceivedDate <System.DateTime>]
    [-Subject <String>]
    [-TeamsConversationTypes <Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]>]
    [-Type <Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageTypeEnum>]
    [<CommonParameters>]

Description

예제

예 1

Get-QuarantineMessage -StartReceivedDate 06/13/2017 -EndReceivedDate 06/15/2017

예 2

Get-QuarantineMessage -PageSize 50 -Page 3

예 3

Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>"

예 4

Get-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 | Format-List

예 5

Get-QuarantineMessage -QuarantineTypes SPOMalware | Format-List

매개 변수

-Direction

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

Direction 매개 변수는 들어오거나 나가는 메시지별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

• 인바운드
• 아웃바운드

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

매개 변수 속성

매개 변수 집합

-Domain

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

매개 변수 집합

-EndExpiresDate

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

EndExpiresDate 매개 변수는 격리에서 자동으로 삭제되는 최신 메시지를 지정합니다. 이 매개 변수는 StartExpiresDate 매개 변수와 함께 사용하십시오.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 2018년 9월 1일을 입력합니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

예를 들어 오늘 날짜의 StartExpiresDate 값과 오늘부터 3일 동안의 EndExpiresDate 값을 지정하면 다음 3일 동안 격리에서 만료되도록 설정된 메시지만 표시됩니다.

매개 변수 속성

매개 변수 집합

-EndReceivedDate

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

EndReceivedDate 매개 변수는 결과로 반환할 최신 메시지를 지정합니다. 이 매개 변수는 StartReceivedDate 매개 변수와 함께 사용하십시오.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 2018년 9월 1일을 입력합니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

매개 변수 속성

매개 변수 집합

-EntityType

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

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

• 전자 메일
• SharePointOnline
• Teams(현재 미리 보기 상태)
• DataLossPrevention

매개 변수 속성

매개 변수 집합

-Identity

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

Identity 매개 변수는 보려는 격리된 메시지를 지정합니다. 값은 형식 GUID1\GUID2 (예 c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7: )의 고유 격리된 메시지 식별자입니다.

이 매개 변수를 사용하여 격리 메시지를 식별하면 RecipientAddress, QuarantineUser 및 ReleasedUser 속성을 사용할 수 있습니다. 이러한 값을 보려면 서식 지정 cmdlet을 사용해야 합니다. 예를 들면 Get-QuarantineMessage -Identity <Identity> | Format-List와 같습니다.

매개 변수 속성

매개 변수 집합

-IncludeMessagesFromBlockedSenderAddress

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

IncludeMessagesFromBlockedSenderAddress 스위치는 차단된 보낸 사람의 격리된 메시지를 결과에 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

-MessageId

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

MessageId 매개 변수는 메시지의 Message-ID 헤더 필드별로 결과를 필터링합니다. 이 값은 클라이언트 ID로도 알려져 있습니다. Message-ID의 형식은 메시지를 보낸 메시징 서버에 따라 달라집니다. 값은 각 메시지에 대해 고유해야 합니다. 그러나 모든 메시징 서버에서 Message-ID 값을 동일한 방식으로 생성하지는 않습니다. 전체 메시지 ID 문자열(꺾쇠 괄호 포함 가능)을 포함하고 값을 따옴표로 묶어야 합니다(예: "<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com>").

매개 변수 속성

매개 변수 집합

-MyItems

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

MyItems 스위치는 명령을 실행하는 사용자가 받는 사람인 메시지로 결과를 필터링합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

-Page

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

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

매개 변수 속성

매개 변수 집합

-PageSize

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

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

매개 변수 속성

매개 변수 집합

-PolicyName

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

PolicyName 매개 변수는 메시지를 격리한 위협 정책(예: 맬웨어 방지 정책 또는 스팸 방지 정책)으로 결과를 필터링합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

• 이름
• DN(고유 이름)
• GUID

매개 변수 속성

매개 변수 집합

-PolicyTypes

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

PolicyTypes 매개 변수는 메시지를 격리한 위협 정책 유형별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

• AntiMalwarePolicy
• AntiPhishPolicy
• DataLossPreventionRule
• ExchangeTransportRule(메일 흐름 규칙)
• HostedContentFilterPolicy(스팸 방지 정책)
• SafeAttachmentPolicy(Office 365용 Microsoft Defender만 해당)

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

매개 변수 속성

매개 변수 집합

-QuarantineTypes

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

QuarantineTypes 매개 변수는 메시지가 격리된 원인으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

• 대량
• DataLossPrevention
• FileTypeBlock(EOP의 맬웨어 방지 정책에서 일반적인 첨부 파일 필터)
• HighConfPhish
• 맬웨어(EOP의 맬웨어 방지 정책 또는 Office 365용 Defender 안전한 첨부 파일 정책)
• 피시 (동음이의)
• 스팸
• SPOMalware(Office 365용 Microsoft Defender만 해당)
• TransportRule

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

Type 매개 변수와 함께 이 매개 변수를 사용할 필요는 없습니다.

SharePoint, OneDrive 및 Microsoft Teams용 안전한 첨부 파일로 격리된 파일의 경우 검색 정보는 출력의 CustomData 필드에서 찾을 수 있습니다.

매개 변수 속성

매개 변수 집합

-RecipientAddress

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

RecipientAddress 매개 변수는 받는 사람의 전자 메일 주소별로 결과를 필터링합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-RecipientTag

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

RecipientTag 매개 변수는 받는 사람의 사용자 태그 값(예: Priority Account)으로 결과를 필터링합니다. 사용자 태그에 대한 자세한 내용은 Office 365용 Defender 사용자 태그를 참조하세요.

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

매개 변수 속성

매개 변수 집합

-ReleaseStatus

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

ReleaseStatus 매개 변수는 메시지의 릴리스 상태 따라 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

• 승인됨
• 승인 거부됨
• 오류
• NotReleased
• PreparingToRelease
• 릴리스됨
• 요청됨

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

참고: 서비스 문제로 인해 Microsoft에서 격리 및 해제한 메시지에는 SystemReleased 속성 값이 TRUE입니다. 시스템 릴리스 메시지로 결과를 필터링하려면 명령을 Get-QuarantineMessage | where {$_.systemreleased -like "True"}실행합니다.

매개 변수 속성

매개 변수 집합

-Reported

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

Reported 매개 변수는 이미 가양성으로 보고된 메시지별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

• $true: 명령은 이미 가양성으로 보고된 격리된 메시지만 반환합니다.
• $false: 명령은 가양성으로 보고되지 않은 격리된 메시지만 반환합니다.

매개 변수 속성

매개 변수 집합

-SenderAddress

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

SenderAddress 매개 변수는 보낸 사람의 전자 메일 주소별로 결과를 필터링합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-StartExpiresDate

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

StartExpiresDate 매개 변수는 격리에서 자동으로 삭제되는 가장 빠른 메시지를 지정합니다. 이 매개 변수는 EndExpiresDate 매개 변수와 함께 사용하십시오.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 2018년 9월 1일을 입력합니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

예를 들어 오늘 날짜의 StartExpiresDate 값과 오늘부터 3일 동안의 EndExpiresDate 값을 지정하면 다음 3일 동안 격리에서 만료되도록 설정된 메시지만 표시됩니다.

매개 변수 속성

매개 변수 집합

-StartReceivedDate

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

StartReceivedDate 매개 변수는 결과로 반환할 가장 오래된 메시지를 지정합니다. 이 매개 변수는 EndReceivedDate 매개 변수와 함께 사용하십시오.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 2018년 9월 1일을 입력합니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

기본적으로 StartReceivedDate 및 EndReceivedDate 매개 변수를 사용하지 않으면 명령은 지난 16일 동안의 데이터를 반환합니다. 이 매개 변수의 최대값은 30일입니다. 30일보다 오래된 값을 사용하는 경우 값은 무시되고 지난 30일 동안의 데이터만 반환됩니다.

매개 변수 속성

매개 변수 집합

-Subject

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

Subject 매개 변수는 메시지의 제목 필드 별로 결과를 필터링합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

매개 변수 속성

매개 변수 집합

-TeamsConversationTypes

적용 가능: 보안 & 규정 준수

이 매개 변수는 Security & Compliance PowerShell에서만 사용할 수 있습니다.

TeamsConversationTypes 매개 변수는 Microsoft Teams 대화 유형별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

• 채널
• 채팅

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

매개 변수 속성

매개 변수 집합

-Type

적용 가능: Exchange Online, 보안 & 규정 준수, Exchange Online Protection

Type 매개 변수는 메시지 격리를 초래한 원인별로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

• 대량
• DataLossPrevention
• HighConfPhish
• 맬웨어
• 피시 (동음이의)
• 스팸
• SPOMalware(Office 365용 Microsoft Defender만 해당)
• TransportRule

QuarantineTypes 매개 변수와 함께 이 매개 변수를 사용할 필요는 없습니다.

SharePoint, OneDrive 및 Microsoft Teams용 안전한 첨부 파일로 보호되는 파일의 경우 검색 정보는 출력의 CustomData 필드에서 찾을 수 있습니다.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

Input types

출력

Output types