Set-PopSettings

 

적용 대상:Exchange Server 2016

마지막으로 수정된 항목:2016-08-23

이 cmdlet은 온-프레미스 Exchange Server 2016에서만 제공됩니다.

Set-PopSettings cmdlet을 사용하여 Microsoft Exchange POP3 서비스의 구성을 수정할 수 있습니다. 이 서비스는 클라이언트 액세스 서버 역할이 설치된 Exchange 서버에 있으며 POP3 클라이언트가 Exchange에 연결하는 데 사용됩니다.

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

Set-PopSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-EnableGSSAPIAndNTLMAuth <$true | $false>] [-EnforceCertificateErrors <$true | $false>] [-ExtendedProtectionPolicy <None | Allow | Require>] [-ExternalConnectionSettings <MultiValuedProperty>] [-InternalConnectionSettings <MultiValuedProperty>] [-LogFileLocation <String>] [-LogFileRollOverSettings <Hourly | Daily | Weekly | Monthly>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-LogPerFileSizeQuota <Unlimited>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-MessageRetrievalSortOrder <Ascending | Descending>] [-OwaServerUrl <Uri>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProtocolLogEnabled <$true | $false>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-SSLBindings <MultiValuedProperty>] [-SuppressReadReceipt <$true | $false>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-X509CertificateName <String>]

이 예에서는 MBX01 서버에 대해 일반 텍스트 연결 또는 TLS 연결을 설정합니다. 이 예에서는 연결이 IP 주소 10.0.0.0과 포트 번호 993를 사용합니다.

Set-PopSettings -Server "MBX01" -UnencryptedOrTLSBindings 10.0.0.0:993

이 예에서는 POP3 프로토콜 로깅을 설정합니다. 또한 POP3 프로토콜 로깅 디렉터리를 C:\Pop3Logging으로 변경합니다.

Set-PopSettings -ProtocolLogEnabled $true -LogFileLocation "C:\Pop3Logging"

이 예에서는 로그 파일이 2MB에 도달했을 때 새 로그 파일을 만들기 위해 POP3 프로토콜 로깅을 변경합니다.

Set-PopSettings -LogPerFileSizeQuota 2000000

이 예에서는 매시간마다 새 로그 파일을 만들기 위해 POP3 프로토콜 로깅을 변경합니다.

Set-PopSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 cmdlet의 모든 매개 변수가 이 항목에 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 필요한 사용 권한을 확인하려면 다음을 참조하세요.클라이언트 및 모바일 장치 사용 권한의 "POP3 설정" 항목

 

매개 변수 필수 종류 설명

AuthenticatedConnectionTimeout

옵션

Microsoft.Exchange.Data.EnhancedTimeSpan

AuthenticatedConnectionTimeout 매개 변수는 유휴 상태의 인증된 연결을 닫기 전까지 대기할 시간을 지정합니다.

값을 지정하려면 시간 범위로 입력합니다. dd.hh:mm:ss 여기서 dd = 일, hh = 시, mm = 분 및 ss = 초입니다.

이 매개 변수의 올바른 입력은 00:00:30에서 1:00:00까지입니다. 기본 설정은 00:30:00 또는 30분입니다.

Banner

선택

System.String

Banner 매개 변수는 POP3 연결이 설정된 후에 표시되는 텍스트 문자열을 지정합니다. 기본값은 다음과 같습니다. The Microsoft Exchange POP3 service is ready..

CalendarItemRetrievalOption

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

CalendarItemRetrievalOption 매개 변수는 POP3를 사용하여 일정에 액세스할 때 반환되는 일정 항목 유형을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

  • 0 또는 iCalendar. 이 값은 기본값입니다.

  • 1 또는 intranetUrl

  • 2 또는 InternetUrl

  • 3 또는 Custom

3 또는 Custom을 지정하는 경우 OwaServerUrl 매개 변수 설정을 사용해야 합니다.

Confirm

선택

System.Management.Automation.SwitchParameter

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 이 스위치가 cmdlet에 영향을 미치는 방식은 계속하기 전에 cmdlet이 확인을 요구하는지에 따라 달라집니다.

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.

  • 대부분의 다른 cmdlet(예: New-*Set-* cmdlet)에는 일시 중지 기능이 기본 제공되어 있지 않습니다. 이러한 cmdlet의 경우 값 없이 Confirm 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

DomainController

옵션

Microsoft.Exchange.Data.Fqdn

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 데이터를 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화 된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

EnableExactRFC822Size

선택

System.Boolean

EnableExactRFC822Size 매개 변수는 서버에서 검색할 수 있는 각 MIME 메시지의 정확한 크기를 계산합니다. 이 매개 변수를 $true로 설정하면 각 MIME 메시지의 정확한 크기를 알아야 하는 POP3 또는 IMAP4 클라이언트 프로그램이 Exchange 서버에 저장된 MIME 메시지의 정확한 크기를 확인할 수 있습니다.

note참고:
기본적으로 이 매개 변수는 $false로 설정되어 있습니다. 이 옵션을 $true로 설정하지 않으면 Exchange 서버에서 POP3 및 IMAP4 클라이언트 프로그램에 반환하는 각 MIME 메시지의 크기가 정확한 메시지 크기와는 약간 다를 수 있습니다. 이 옵션을 $true로 설정하면 성능이 저하될 수 있으므로 대부분의 사용자가 MIME 메시지의 정확한 크기를 알아야 하는 클라이언트를 사용하는 경우에만 이 옵션을 사용해야 합니다.

EnableGSSAPIAndNTLMAuth

선택

System.Boolean

EnableGSSAPIAndNTLMAuth 매개 변수는 연결에 GSSAPI(Generic Security Services Application Programming Interface)를 사용하여 Windows 통합 인증(NTLM)을 사용할지 여부를 지정합니다. 이 설정은 TLS(전송 계층 보안)가 비활성화된 연결에 적용됩니다. 기본적으로 이 매개 변수는 $true으로 설정됩니다. 이 매개 변수 값을 $false로 설정하면 POP3 연결에 NTLM을 사용하지 않을 수 있습니다. POP3 연결에 대한 NTLM 인증 지원은 Exchange 2010 SP1(서비스 팩 1) 이상에서 사용할 수 있습니다.

EnforceCertificateErrors

선택

System.Boolean

EnforceCertificateErrors 매개 변수는 유효한 SSL(Secure Sockets Layer) 인증서를 적용할지 여부를 지정합니다. 이 매개 변수를 사용하려면 유효한 SSL 인증서를 적용할 대상 서버를 지정합니다. EnforceCertificateErrors 매개 변수를 $true로 설정했는데 프록시의 대상 인증서가 유효하지 않으면 프록시 로그온 시도가 실패합니다.

기본 설정은 $false입니다.

ExtendedProtectionPolicy

옵션

Microsoft.Exchange.Data.Directory.SystemConfiguration.ExtendedProtectionTokenCheckingMode

ExtendedProtectionPolicy 매개 변수는 POP3 인증 연결에 확장된 보호를 사용하는 방법을 지정합니다. 기본적으로 이 매개 변수는 None으로 설정됩니다. 가능한 값은 다음과 같습니다.

  • None   인증에 대한 확장된 보호가 사용되지 않습니다.

  • Allow   연결되는 POP3 연결이 지원하는 경우에만 인증에 대한 확장된 보호가 사용됩니다. 그렇지 않은 경우 인증에 대한 확장된 보호 없이 연결이 설정됩니다.

  • Require   모든 POP3 연결에는 인증에 대한 확장된 보호가 필요합니다. 연결되는 호스트가 인증에 대한 확장된 보호를 지원하지 않는 경우 연결이 거부됩니다.

통합 Windows 인증을 사용하여 네트워크 연결을 인증하는 경우 인증에 대한 확장된 보호를 통해 자격 증명의 보호 및 처리가 향상됩니다. 통합 Windows 인증은 NTLM이라고도 합니다. 통합 Windows 인증을 사용하는 경우 인증에 대한 확장된 보호를 사용하는 것이 좋습니다. 인증에 대한 확장된 보호를 사용하려면 클라이언트와 서버 컴퓨터가 특정 요구 사항을 만족해야 합니다. 운영 체제 요구 사항과 보안 업데이트 요구 사항이 이에 해당됩니다. 또한 POP3 클라이언트 프로그램이 인증에 대한 확장된 보호 기능 사용을 지원해야 합니다.

ExternalConnectionSettings

옵션

Microsoft.Exchange.Data.MultiValuedProperty

ExternalConnectionSettings 매개 변수는 POP3 클라이언트가 회사 네트워크 외부에서 사서함에 연결할 때 사용되는 호스트 이름, 포트 및 암호화 유형(옵션)을 지정합니다.

값은 <HostName>:<Port>:[<TLS | SSL>]. 암호화 유형 값은 선택 사항입니다.

여러 값을 입력하고 기존 항목을 덮어쓰려면 다음 구문을 사용합니다. <value1>,<value2>.... 값에 공백이 포함되어 있거나 인용 부호가 필요한 경우 다음 구문을 사용해야 합니다. "<value1>","<value2>"....

기존 항목에 영향을 주지 않고 하나 이상의 값을 추가하거나 제거하려면 다음 구문을 사용합니다. @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

InternalConnectionSettings

옵션

Microsoft.Exchange.Data.MultiValuedProperty

InternalConnectionSettings 매개 변수는 POP3 클라이언트가 회사 네트워크 내부에서 사서함에 연결할 때 사용되는 호스트 이름, 포트 및 암호화 유형(옵션)을 지정합니다. 이 설정은 사용자 연결이 Microsoft Exchange POP3 서비스가 실행되는 다른 Exchange 서버로 전달될 때도 사용됩니다.

다음 형식으로 값을 입력합니다. <HostName>:<Port>:[<TLS | SSL>]. 암호화 유형 값은 선택 사항입니다.

여러 값을 입력하고 기존 항목을 덮어쓰려면 다음 구문을 사용합니다. <value1>,<value2>.... 값에 공백이 포함되어 있거나 인용 부호가 필요한 경우 다음 구문을 사용해야 합니다. "<value1>","<value2>"....

기존 항목에 영향을 주지 않고 하나 이상의 값을 추가하거나 제거하려면 다음 구문을 사용합니다. @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

이 매개 변수에 대한 기본값은 <ServerFQDN>:995:SSL,<ServerFQDN>:110:TLS입니다.

LogFileLocation

선택

System.String

LogFileLocation 매개 변수는 POP3 프로토콜 로그 파일의 위치를 지정합니다. 기본 위치는 %ExchangeInstallPath%Logging\Pop3입니다.

LogFileRollOverSettings

선택

Microsoft.Exchange.Diagnostics.LogFileRollOver

LogFileRollOverSettings 매개 변수는 POP3 프로토콜 로깅이 새 로그 파일을 만드는 빈도를 정의합니다. 사용할 수 있는 값은 다음과 같습니다.

  • 1 또는 Hourly

  • 2 또는 Daily. 이 값은 기본값입니다.

  • 3 또는 Weekly

  • 4 또는 Monthly

이 설정은 LogPerFileSizeQuota 매개 변수의 값이 0으로 설정된 경우에만 적용됩니다.

LoginType

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

LoginType 매개 변수는 POP3 연결에 대한 인증 방법을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

  • 1 또는 PlainTextLogin

  • 2 또는 PlainTextAuthentication

  • 3 또는 SecureLogin. 이 값은 기본값입니다.

LogPerFileSizeQuota

옵션

Microsoft.Exchange.Data.Unlimited

LogPerFileSizeQuota 매개 변수는 POP3 프로토콜 로그 파일의 최대 크기(바이트)를 정의합니다. 기본적으로 이 값은 0으로 설정됩니다. 이 값이 0으로 설정된 경우 LogFileRollOverSettings 매개 변수에 지정된 빈도에 새 프로토콜 로그 파일이 만들어집니다.

MaxCommandSize

옵션

System.Int32

MaxCommandSize 매개 변수는 단일 명령의 최대 크기를 지정합니다. 기본 크기는 512바이트입니다. 40바이트에서 1024바이트까지의 값을 사용할 수 있습니다.

MaxConnectionFromSingleIP

옵션

System.Int32

MaxConnectionFromSingleIP 매개 변수는 지정된 서버가 수락하는 단일 IP 주소의 연결 수를 지정합니다. 기본값은 2147483647입니다. 가능한 값은 1에서 2147483647까지입니다.

MaxConnections

옵션

System.Int32

MaxConnections 매개 변수는 지정된 서버가 수락하는 총 연결 수를 지정합니다. 여기에는 인증된 연결과 인증되지 않은 연결이 모두 포함됩니다. 기본값은 2147483647입니다. 가능한 값은 1에서 2147483647까지입니다.

MaxConnectionsPerUser

옵션

System.Int32

MaxConnectionsPerUser 매개 변수는 특정 사용자의 최대 POP3 연결 수를 지정합니다. 기본값은 16입니다. 유효한 값은 1에서 2147483647 사이의 값입니다.

MessageRetrievalMimeFormat

옵션

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

MessageRetrievalMimeFormat 매개 변수는 메시지의 MIME 인코딩을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

  • 0 또는 TextOnly

  • 1 또는 HtmlOnly

  • 2 또는 HtmlAndTextAlternative

  • 3 또는 TextEnrichedOnly

  • 4 또는 TextEnrichedAndTextAlternative

  • 5 또는 BestBodyFormat. 이 값은 기본값입니다.

  • 6 또는 Tnef

자세한 내용은 POP3 및 IMAP4 메시지 검색 형식 옵션 구성 항목을 참조하십시오.

MessageRetrievalSortOrder

옵션

Microsoft.Exchange.Data.SortOrder

MessageRetrievalSortOrder 매개 변수는 검색한 메시지가 정렬되는 순서를 지정합니다. 이 값은 0(오름차순) 또는 1(내림차순)일 수 있습니다. 기본값은 Ascending입니다.

OwaServerUrl

옵션

System.Uri

OwaServerUrl 매개 변수는 사용자 지정 웹에서 Outlook 일정 항목의 인스턴스에 대한 일정 정보를 검색할 위치를 지정합니다.

PreAuthenticatedConnectionTimeout

옵션

Microsoft.Exchange.Data.EnhancedTimeSpan

PreAuthenticatedConnectionTimeout 매개 변수는 인증되지 않은 유휴 연결을 닫기 전까지 대기할 시간을 지정합니다.

값을 지정하려면 시간 범위로 입력합니다. dd.hh:mm:ss 여기서 dd = 일, hh = 시, mm = 분 및 ss = 초입니다.

유효한 값은 00:00:30에서 1:00:00까지입니다. 기본값은 00:01:00(1분)입니다.

ProtocolLogEnabled

선택

System.Boolean

ProtocolLogEnabled 매개 변수는 프로토콜 로깅을 사용할지 여부를 지정합니다. 기본 설정은 $false입니다. 자세한 내용은 POP3 및 IMAP4 프로토콜 로깅 구성 항목을 참조하십시오.

ProxyTargetPort

옵션

System.Int32

ProxyTargetPort 매개 변수는 Microsoft Exchange POP3 서비스에서 프록시된 클라이언트 연결을 수신 대기하는 Microsoft Exchange POP3 백 엔드 서비스의 포트를 지정합니다. 기본값은 1995입니다.

Server

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 매개 변수는 이 명령을 실행하려는 Exchange 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름

  • FQDN

  • DN(고유 이름)

  • Exchange 레거시 DN

이 매개 변수를 사용하지 않으면 로컬 서버에서 명령이 실행됩니다.

SSLBindings

옵션

Microsoft.Exchange.Data.MultiValuedProperty

SSLBindings 매개 변수는 명령에서 SSL 세션에 사용할 IP 주소와 포트 번호를 설정할지 여부를 지정합니다. 이것은 다중값 속성입니다. 값은 <IP 주소>:<포트 번호>.

기본값은 0.0.0.0:995입니다.

SuppressReadReceipt

선택

System.Boolean

SuppressReadReceipt 매개 변수는 POP3 전자 메일 프로그램에서 보내는 메시지에 대한 읽음 확인 보내기 옵션을 사용하는 POP3 보낸 사람에게 중복된 읽음 확인을 보내는 것을 중지할지 여부를 지정합니다. 기본적으로 이 옵션은 $false로 설정됩니다. 기본적으로 보내는 메시지에 대한 읽음 확인 보내기 옵션을 사용하는 POP3 보낸 사람은 다음 두 상황 모두에서 읽음 확인을 수신합니다.

  • 받는 사람이 전송한 메시지를 다운로드한 경우

  • 받는 사람이 메시지를 여는 경우

이 매개 변수의 유효한 값과 설명은 다음과 같습니다.

  • $false   받는 사람이 메시지를 다운로드할 때마다 POP3 사용자에게 읽음 확인이 전송됩니다. 사용자가 메시지를 연 경우에도 POP3 사용자에게 읽음 확인이 전송됩니다.

  • $true 전자 메일 클라이언트 프로그램에서 보내는 메시지에 대한 읽음 확인 보내기 옵션을 사용하는 POP3 사용자는 받는 사람이 메시지를 열 때만 읽음 확인을 수신합니다.

UnencryptedOrTLSBindings

옵션

Microsoft.Exchange.Data.MultiValuedProperty

UnencryptedOrTLSBindings 매개 변수는 TLS 암호화된 연결 또는 암호화되지 않은 연결의 통신에 사용할 IP 주소와 포트 번호를 지정합니다. 이것은 다중값 속성입니다. 값은 <IP 주소>:<포트 번호>.

기본값은 0.0.0.0:110입니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

WhatIf 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

X509CertificateName

선택

System.String

X509CertificateName 매개 변수는 관련 주체 필드의 SSL 인증서에 있는 호스트 이름을 지정합니다.

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

 
표시: