다음을 통해 공유

New-MailUser(RTM)

  • 아티클

 

적용 대상: Exchange Server 2007

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

New-MailUser cmdlet를 사용하여 새 메일 사용 가능 사용자를 만들 수 있습니다.

구문

New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]

자세한 정보

New-MailUser cmdlet는 Active Directory 디렉터리 서비스에서 새 메일 사용 가능 사용자 개체를 만듭니다.

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

  • Exchange 받는 사람 관리자 역할

  • 해당하는 Active Directory 컨테이너에 대한 계정 운영자 역할

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

참고

New-MailUser cmdlet로는 일부 사용자 특성을 설정할 수 없습니다. Set-User cmdlet를 사용하여 추가 설정을 지정할 수 있습니다.

매개 변수

매개 변수 필수 종류 설명

ExternalEmailAddress

필수

Microsoft.Exchange.Data.ProxyAddress

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

Name

필수

System.String

Name 매개 변수는 메일 사용 가능 사용자의 CN(일반 이름)을 지정합니다.

OrganizationalUnit

필수

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 매개 변수는 새 사용자가 추가되는 조직 구성 단위(예: redmond.contoso.com/contacts)를 지정합니다.

Password

필수

System.Security.SecureString

Password 매개 변수는 메일 사용자가 계정 보안 유지에 사용하는 암호를 지정합니다.

UserPrincipalName

필수

System.String

UserPrincipalName 매개 변수는 시스템 사용자의 이름을 전자 메일 주소 형식(예: ted@contoso.com)으로 정의합니다.

Alias

선택

System.String

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

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

DisplayName

선택

System.String

DisplayName 매개 변수는 Microsoft Outlook에 표시되는 메일 사용자의 이름을 지정합니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

FirstName

선택

System.String

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

Initials

선택

System.String

Initials 매개 변수는 메일 사용자의 이니셜을 지정합니다.

LastName

선택

System.String

LastName 매개 변수는 메일 사용자의 성을 지정합니다.

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 값만을 사용할 수 있습니다.

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로 변경해야 합니다.

ResetPasswordOnNextLogon

선택

System.Boolean

ResetPasswordOnNextLogon 매개 변수를 $true로 설정하면 사용자는 다음 로그온 시 암호를 변경해야 합니다.

SamAccountName

선택

System.String

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

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

TemplateInstance

선택

System.Management.Automation.PSObject

TemplateInstance 매개 변수에 기존 개체를 제공하면, 이 명령은 해당 개체의 구성을 사용하여 로컬 또는 대상 서버에서 해당 개체의 동일한 복제본을 만듭니다.

UsePreferMessageFormat

선택

System.Boolean

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

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

다음 예는 두 가지 명령으로 구성됩니다.

첫 번째 명령에서는 System.Security.SecureString 형식의 암호 $password가 생성됩니다. 명령이 실행되면 프롬프트 "Enter password"가 표시됩니다. 사용자가 입력하는 문자열이 새 암호 문자열 $password가 됩니다.

두 번째 명령은 메일 사용 가능 사용자 개체인 Ted Bremer를 새로 만들고 새로 만든 암호를 Password 매개 변수를 통해 개체에 할당합니다. Ted는 Tailspin Toys의 직원이지만 Contoso사의 직원들과 협력해서 작업하는 경우가 많으므로 contoso.com의 전자 메일 주소가 부여됩니다. Contoso의 Exchange Server에는 Ted의 사서함이 없습니다. Ted의 contoso.com 전자 메일 주소로 전송되는 전자 메일 메시지는 외부 전자 메일 주소인 ted@tailspintoys.com으로 전송됩니다.

$password = Read-Host "Enter password" -AsSecureString
New-MailUser -Name "Ted Bremer" -Password $password -ExternalEmailAddress ted@tailspintoys.com -UserPrincipalName ted@contoso.com -OrganizationalUnit contoso.com