Export-QuarantineMessage
이 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 |