Export-QuarantineMessage

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Online, Security & Compliance, Exchange Online Protection

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

Export-QuarantineMessage cmdlet을 사용하여 클라우드 기반 organization 격리된 메시지 및 파일을 내보냅니다. Outlook에서 메시지를 열 수 있도록 메시지를 .eml 메시지 파일로 내보냅니다.

SharePoint, OneDrive 및 Microsoft Teams용 안전한 첨부 파일에 의해 격리된 파일의 경우 파일은 Base64 형식으로 내보내집니다.

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

Syntax

Export-QuarantineMessage
      -Identities <QuarantineMessageIdentity[]>
      [-Identity <QuarantineMessageIdentity>]
      [-CompressOutput]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-ForceConversionToMime]
      [-Password <SecureString>]
      [-ReasonForExport <String>]
      [-RecipientAddress <String>]
      [<CommonParameters>]

Export-QuarantineMessage
      -Identity <QuarantineMessageIdentity>
      [-CompressOutput]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-ForceConversionToMime]
      [-Password <SecureString>]
      [-ReasonForExport <String>]
      [-RecipientAddress <String>]
      [<CommonParameters>]

Description

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

예제

예 1

$e = Export-QuarantineMessage -Identity b28e0706-e50e-4c33-17e8-08daf2898d15\e939baaf-9dac-6126-2137-b82abf373159

$txt = [System.Text.Encoding]::Ascii.GetString([System.Convert]::FromBase64String($e.eml))

[IO.File]::WriteAllText("C:\My Documents\Quarantined Message.eml", $txt)

다음은 스팸으로 격리된 지정된 메시지를 내보내는 예제입니다.

첫 번째 명령은 격리된 메시지를 변수 $e로 내보냅니다. 메시지는 Eml 속성( $e.eml 값)에 Base64(값 기준 $e.BodyEncoding )로 저장됩니다.
두 번째 명령은 Eml 속성을 Base64에서 ASCII 텍스트로 변환하고 결과를 변수 $txt에 저장합니다.
세 번째 명령은 격리된 메시지를 지정된 .eml 파일에 씁니다.

참고: ID 값을 따옴표로 묶지 마세요(오류가 발생할 수 있습니다).

예 2

$f = Export-QuarantineMessage -Identity 9c6bb3e8-db9e-4823-9759-08d594179bd3\7fec89fe-41b0-ae67-4887-5bede017d111

$bytes = [Convert]::FromBase64String($f.eml)

[IO.File]::WriteAllBytes("C:\My Documents\Quarantined Message with Attachments.eml", $bytes)

다음은 지정된 메시지를 맬웨어로 격리된 첨부 파일로 내보내는 예제입니다.

첫 번째 명령은 격리된 메시지와 첨부 파일을 변수 $f로 내보냅니다. 메시지 및 첨부 파일은 Eml 속성( $f.eml 값)에 Base64(값 기준 $f.BodyEncoding )로 저장됩니다.
두 번째 명령은 Eml 속성을 Base64에서 바이트로 변환하고 결과를 변수 $bytes에 저장합니다.
세 번째 명령은 격리된 메시지와 첨부 파일을 지정된 .eml 파일에 씁니다.

매개 변수

-CompressOutput

CompressOutput 스위치는 메시지를 압축된 .zip 파일로 내보냅니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

첨부 파일이 있는 메시지를 포함하여 내보낸 메시지의 경우 .zip 파일에는 ID의 첫 번째 GUID 값 이름을 따서 명명된 폴더가 포함됩니다. 폴더에는 ID의 두 번째 GUID 값 이름을 따서 명명된 .eml 메시지가 포함됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance, Exchange Online Protection

-EntityType

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

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

Type:	Microsoft.Exchange.Management.FfoQuarantine.EntityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ForceConversionToMime

ForceConversionToMime 스위치는 내보낸 일반 문자 메시지를 MIME 서식으로 변환합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

메시지가 이미 Base64로 인코딩된 경우에는 이 스위치가 적용되지 않습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identities

Identities 매개 변수는 대량 작업에 대해 격리된 메시지를 식별합니다. 구문을 value1,value2...valueN사용하여 메시지를 식별합니다. 각 값은 형식 GUID1\GUID2 (예 c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7: )의 고유한 격리된 메시지 식별자입니다.

Get-QuarantineMessage cmdlet을 사용하여 격리된 메시지에 대한 Identity 값을 찾을 수 있습니다.

이 매개 변수를 사용하는 경우 Identity 매개 변수가 필요하지만 값은 무시됩니다. 예를 들어 Identity 매개 변수에 값 000을 사용합니다.

Type:	QuarantineMessageIdentity[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

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

Get-QuarantineMessage cmdlet을 사용하여 격리된 메시지에 대한 Identity 값을 찾을 수 있습니다.

Type:	QuarantineMessageIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Password

Password 매개 변수는 내보낸 메시지를 여는 데 필요한 암호를 지정합니다.

다음 메서드를 이 매개 변수의 값으로 사용할 수 있습니다.

(ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
이 명령을 실행하기 전에 암호를 변수(예 $password = Read-Host "Enter password" -AsSecureString: )로 저장한 다음 값에 변수($password)를 사용합니다.
(Get-Credential).password 이 명령을 실행할 때 암호를 안전하게 입력하라는 메시지가 표시됩니다.

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReasonForExport

ReasonForExport 매개 변수는 메시지를 내보낸 이유를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-RecipientAddress

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection