Set-MailUser(RTM)

  • 아티클

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2007-06-05

Set-MailUser cmdlet를 사용하면 Active Directory 디렉터리 서비스에서 기존 사용자의 메일 관련 특성을 수정할 수 있습니다.

구문

set-MailUser -Identity <MailUserIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-WindowsEmailAddress <SmtpAddress>]

set-MailUser [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <MailUser>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-WindowsEmailAddress <SmtpAddress>]

자세한 정보

Set-MailUser cmdlet를 사용하면 Active Directory에서 메일 사용이 가능한 사용자의 메일 관련 특성을 수정할 수 있습니다.

Set-MailUser cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • Exchange 받는 사람 관리자 역할

사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

참고

Set-MailUser cmdlet로는 일부 사용자 특성만 수정할 수 있습니다. Set-User cmdlet를 사용하면 메일과 관련이 없는 사용자 특성을 추가로 설정할 수 있습니다.

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Identity 매개 변수에는 다음 값 중 하나를 사용할 수 있습니다.

  • ADObjectID

  • GUID

  • DN(고유 이름)

  • Domain\SamAccountName

  • UPN(User Principal Name)

  • 레거시 DN

  • 전자 메일 주소

  • 사용자 별칭

  • Instance 매개 변수가 지정된 경우에는 Identity 매개 변수를 사용할 수 없습니다.

AcceptMessagesOnlyFrom

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFrom 매개 변수는 이 메일 사용자에게 전자 메일 메시지를 보낼 수 있는 받는 사람을 지정합니다. 유효한 보낸 사람에 대해 다음 값을 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • Name

  • 표시 이름

  • Alias

  • 레거시 Exchange DN

  • 기본 SMTP(Simple Mail Transfer Protocol) 전자 메일 주소

기본적으로 이 매개 변수는 비어 있습니다. 이 매개 변수를 비워 두면 사서함 사용자는 모든 받는 사람의 메시지를 수락할 수 있습니다.

AcceptMessagesOnlyFromDLMembers

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFromDLMembers 매개 변수는 이 메일 사용자에게 전자 메일 메시지를 보낼 수 있도록 허용된 메일 그룹을 지정합니다. 허용된 메일 그룹에 대해 다음 값을 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • Name

  • 표시 이름

  • 레거시 Exchange DN

  • 기본 SMTP 전자 메일 주소

기본적으로 이 매개 변수는 비어 있습니다.

Alias

선택

System.String

Alias 매개 변수는 사용자의 별칭을 지정합니다. 별칭에는 문자, 숫자 및 다음과 같은 문장 부호와 기호가 포함될 수 있습니다.

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

CreateDTMFMap

선택

System.Boolean

이 매개 변수는 사용자에 대해 DTMF(복합 주파수 부호) 맵을 만들도록 지정합니다.

CustomAttribute1

선택

System.String

CustomAttribute1 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute10

선택

System.String

CustomAttribute10 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute11

선택

System.String

CustomAttribute11 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute12

선택

System.String

CustomAttribute12 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute13

선택

System.String

CustomAttribute13 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute14

선택

System.String

CustomAttribute14 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute15

선택

System.String

CustomAttribute15 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute2

선택

System.String

CustomAttribute2 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute3

선택

System.String

CustomAttribute3 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute4

선택

System.String

CustomAttribute4 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute5

선택

System.String

CustomAttribute5 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute6

선택

System.String

CustomAttribute6 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute7

선택

System.String

CustomAttribute7 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute8

선택

System.String

CustomAttribute8 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute9

선택

System.String

CustomAttribute9 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

DisplayName

선택

System.String

DisplayName 매개 변수는 사용자의 표시 이름을 지정합니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 구성 변경을 Active Directory에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다.

EmailAddresses

선택

Microsoft.Exchange.Data.ProxyAddressCollection

EmailAddresses 매개 변수는 메일 그룹 프록시 전자 메일 주소를 지정합니다.

EmailAddressPolicyEnabled

선택

System.Boolean

EmailAddressPolicyEnabled 매개 변수는 사서함의 전자 메일 주소가 정의된 전자 메일 주소 정책에 따라 자동으로 업데이트될지 여부를 지정합니다. 이 매개 변수를 $true로 설정하면 PrimarySmtpAddress 또는 WindowsEmailAddress 매개 변수를 변경할 수 없습니다.

Extensions

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 사용자의 내선 번호를 하나 이상 지정합니다. 이 매개 변수를 설정할 때는 다이얼 플랜에 있는 모든 내선 번호가 고유해야 합니다.

ExternalEmailAddress

선택

Microsoft.Exchange.Data.ProxyAddress

ExternalEmailAddress 매개 변수는 조직 외부의 전자 메일 주소를 지정합니다. 사용자에게 보내진 전자 메일 메시지는 이 외부 주소로 보내집니다.

GrantSendOnBehalfTo

선택

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[]

GrantSendOnBehalfTo 매개 변수는 이 사용자 대신 메시지를 보낼 수 있는 받는 사람의 DN(고유 이름)을 지정합니다.

HiddenFromAddressListsEnabled

선택

System.Boolean

HiddenFromAddressListsEnabled 매개 변수는 사용자가 주소 목록에 나타날지 여부를 지정합니다. 기본값은 $false입니다.

Instance

선택

Microsoft.Exchange.Data.Directory.Management.MailUser

Instance 매개 변수를 사용하면 처리할 명령에 전체 개체를 전달할 수 있습니다. 이 매개 변수는 주로 전체 개체를 명령에 전달해야 하는 스크립트에서 사용됩니다.

MacAttachmentFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

MacAttachmentFormat 매개 변수는 메일 사용자에게 보내는 메시지에 대해 Apple Macintosh 운영 체제 첨부 파일 형식을 지정합니다. 이 매개 변수의 유효한 값은 다음과 같습니다.

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

기본적으로 이 매개 변수는 BinHex로 설정됩니다.

MacAttachmentFormat 매개 변수에 사용할 수 있는 적합한 값은 MessageFormat 매개 변수에 따라 달라집니다. MessageFormat 매개 변수가 Text로 설정되어 있으면 이 매개 변수에 대해 BinHex 또는 UUENCODE 값만을 사용할 수 있습니다. 그리고 MessageFormat 매개 변수가 Mime으로 설정되어 있으면 이 매개 변수에 대해 BinHex, AppleSingle 또는 AppleDouble 값만을 사용할 수 있습니다.

MaxReceiveSize

선택

Microsoft.Exchange.Data.Unlimited

MaxReceiveSize 매개 변수는 메일 사용자가 받을 수 있는 전자 메일 메시지의 최대 크기를 1KB에서 2,097,151KB 사이로 지정합니다.

이 매개 변수를 지정하지 않으면 크기 제한이 없습니다.

MaxSendSize

선택

Microsoft.Exchange.Data.Unlimited

MaxSendSize 매개 변수는 메일 사용자가 보낼 수 있는 전자 메일 메시지의 최대 크기를 1KB에서 2,097,151KB 사이로 지정합니다.

이 매개 변수를 지정하지 않으면 크기 제한이 없습니다.

MessageBodyFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

MessageBodyFormat 매개 변수는 메일 사용자에게 보내는 메시지에 대해 메시지 본문 형식을 지정합니다. 이 매개 변수의 유효한 값은 다음과 같습니다.

  • 텍스트

  • Html

  • TextAndHtml

기본적으로 이 매개 변수는 TextAndHtml로 설정됩니다.

MessageFormat 및 MessageBodyFormat 매개 변수는 각각 서로에게 영향을 줍니다. 즉, MessageFormat 매개 변수가 Mime로 설정되어 있으면 MessageBodyFormat 매개 변수를 모든 유효한 값으로 설정할 수 있지만 MessageFormat 매개 변수가 Text로 설정되어 있으면 MessageBodyFormat 매개 변수도 Text로만 설정할 수 있습니다. 그러므로 이 매개 변수를 Html 또는 TextAndHtml로 설정하려면 MessageFormat 매개 변수도 Mime으로 설정해야 합니다.

MessageFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

MessageFormat 매개 변수는 메일 사용자에게 보내는 메시지에 대해 메시지 형식을 지정합니다.

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

  • 텍스트

  • Mime

기본적으로 이 매개 변수는 Mime으로 설정됩니다.

MessageFormat 및 MessageBodyFormat 매개 변수는 각각 서로에게 영향을 줍니다. 즉, MessageFormat 매개 변수가 Mime으로 설정되어 있으면 MessageBodyFormat 매개 변수를 모든 유효한 값으로 설정할 수 있지만 MessageFormat 매개 변수가 Text로 설정되어 있으면 MessageBodyFormat 매개 변수도 Text로만 설정할 수 있습니다. 그러므로 MessageFormat 매개 변수를 Mime에서 Text로 변경하려면 MessageBodyFormat 매개 변수도 Text로 변경해야 합니다.

Name

선택

System.String

Name 매개 변수는 사용자의 이름을 지정합니다.

PrimarySmtpAddress

선택

Microsoft.Exchange.Data.SmtpAddress

PrimarySmtpAddress 매개 변수는 주 SMTP 주소를 지정합니다.

RecipientLimits

선택

Microsoft.Exchange.Data.Unlimited

RecipientLimits 매개 변수는 이 사용자가 보낸 메시지의 최대 받는 사람 수를 지정합니다.

RejectMessagesFrom

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFrom 매개 변수는 메시지를 거부할 받는 사람을 지정합니다.

RejectMessagesFromDLMembers

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFromDLMembers 매개 변수는 메시지를 거부할 메일 그룹 구성원을 지정합니다.

RequireSenderAuthenticationEnabled

선택

System.Boolean

RequireSenderAuthenticationEnabled 매개 변수는 인증된 받는 사람의 메시지만 수락할지 여부를 지정합니다. 기본값은 $false입니다.

SamAccountName

선택

System.String

SamAccountName 매개 변수는 Microsoft Windows NT 4.0, Windows 98, Windows 95, LAN Manager와 같은 이전 버전의 운영 체제에서 실행되는 클라이언트와 서버를 지원하는 데 사용되는 로그온 이름을 정의합니다. 이 특성은 20 자 이내여야 합니다. 계정 이름에는 문자, 숫자 및 다음과 같은 문장 부호와 기호가 포함될 수 있습니다.

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

SecondaryAddress

선택

System.String

이 매개 변수는 UM 사용 가능 사용자가 사용하는 보조 주소를 지정합니다.

SecondaryDialPlan

선택

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

이 매개 변수는 사용할 보조 UM 다이얼 플랜을 지정합니다. 이 매개 변수는 보조 프록시 주소를 만들 수 있도록 제공됩니다.

SimpleDisplayName

선택

System.String

SimpleDisplayName 매개 변수는 제한된 문자 집합만 허용되는 경우 개체에 대한 대체 설명을 표시하는 데 사용됩니다. 제한된 문자 집합은 26자에서 126자까지의 ASCII 문자로 구성됩니다.

UMDtmfMap

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 UM 사용 가능 사용자에 대해 사용자 정의 DTMF 맵을 만들지 여부를 지정합니다.

UseMapiRichTextFormat

선택

Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat

UseMapiRichTextFormat 매개 변수는 이 메일 사용자에 대해 MAPI 서식 있는 텍스트(RTF)의 메시지를 처리하는 방식을 지정합니다. 이 사용자에게 보낸 모든 메시지를 일반 텍스트로 변환하려면 이 매개 변수를 Never로 설정하고 항상 이 사용자에게 MAPI RTF 형식으로 메시지를 보내려면 이 매개 변수를 Always로 설정합니다. 또한 메시지를 보낸 MAPI 클라이언트에 구성된 설정에 따라 형식을 결정하려면 이 매개 변수를 UseDefaultSettings로 설정합니다.

UsePreferMessageFormat

선택

System.Boolean

UsePreferMessageFormat 매개 변수는 메일 사용자에 대해 구성된 메시지 형식 설정이 원격 도메인에 대해 구성된 전역 설정을 대신할지 여부를 지정합니다. 모든 전역 설정 대신 메일 사용자에 대해 구성된 메시지 형식 설정을 사용하려면 이 매개 변수를 $true로 설정합니다.

UserPrincipalName

선택

System.String

UserPrincipalName 매개 변수는 사용자의 UPN(사용자 이름)을 지정합니다.

WindowsEmailAddress

선택

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress 매개 변수는 이 사서함의 Windows 전자 메일 주소를 지정합니다. 이 주소는 Exchange에서 사용되지 않습니다.

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

이 예에서 Set-MailUser 명령은 메일 사용이 가능한 사용자 John Peoples의 전자 메일이 보내지는 조직 외부의 전자 메일 주소를 설정하는 데 사용됩니다.

Set-MailUser john -ExternalEmailAddress john@tailspintoys.com