New-Mailbox

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

마지막으로 수정된 항목: 2009-05-12

New-Mailbox cmdlet를 사용하여 Active Directory 디렉터리 서비스에 새 사용자를 만들고 사서함을 사용할 수 있게 만들 수 있습니다.

구문

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

자세한 정보

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

  • Exchange 받는 사람 관리자 역할

  • 적용 가능한 Active Directory 컨테이너에 대한 계정 운영자 역할

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

참고

관리되는 사용자 지정 폴더는 MRM(메시징 레코드 관리)의 고급 기능입니다. 관리되는 사용자 지정 폴더가 포함된 사서함에 정책을 사용하려면 Exchange Server Enterprise CAL(클라이언트 액세스 라이선스)이 필요합니다.

매개 변수

매개 변수 필수 종류 설명

Database

필수

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Database 매개 변수는 새 사용자의 사서함을 포함할 Exchange 데이터베이스를 지정합니다. 다음 값을 사용할 수 있습니다.

  • 데이터베이스의 GUID

  • 데이터베이스 이름

  • 서버 이름\데이터베이스 이름

  • 서버 이름\저장소 그룹\데이터베이스 이름

Equipment

필수

System.Management.Automation.SwitchParameter

Equipment 매개 변수는 이 사서함이 리소스 사서함인 경우 리소스 종류가 장비임을 지정합니다. 이 매개 변수는 리소스 사서함을 만드는 경우에만 필요합니다.

LinkedDomainController

필수

System.String

LinkedDomainController 매개 변수는 사용자 계정이 있는 포리스트의 도메인 컨트롤러를 지정합니다. 이 포리스트의 도메인 컨트롤러는 LinkedMasterAccount 매개 변수로 지정된 계정의 보안 정보를 가져오는 데 사용됩니다. 이 매개 변수는 연결된 사서함을 만드는 경우에만 필요합니다.

LinkedMasterAccount

필수

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

LinkedMasterAccount 매개 변수는 사용자 계정이 있는 포리스트의 마스터 계정을 지정합니다. 마스터 계정은 사서함을 연결하는 계정입니다. 마스터 계정은 사서함에 대한 액세스 권한을 부여합니다. 이 매개 변수는 연결된 사서함을 만드는 경우에만 필요합니다. 다음 값 중 하나를 사용할 수 있습니다.

  • GUID

  • DN(고유 이름)

  • 도메인\계정

  • UPN(사용자 이름)

  • LegacyExchangeDN

  • SmtpAddress

  • 별칭

Name

필수

System.String

Name 매개 변수는 사용자의 이름을 지정합니다. 이 이름은 Active Directory 사용자 및 컴퓨터에 나타나는 이름입니다. 또한 이 이름은 사용자 정보 탭의 받는 사람 속성에도 나타납니다.

Password

필수

System.Security.SecureString

Password 매개 변수는 새로 만든 사용자의 초기 암호를 지정합니다. 연결된 사서함이나 리소스 사서함 또는 공유 사서함은 사용할 수 없기 때문에 이러한 유형의 사서함을 만드는 경우에는 이 매개 변수가 필요하지 않습니다.

Room

필수

System.Management.Automation.SwitchParameter

Room 매개 변수는 이 사서함이 리소스 사서함인 경우 리소스 종류가 회의실임을 지정합니다. 이 매개 변수는 리소스 사서함을 만드는 경우에만 필요합니다.

Shared

필수

System.Management.Automation.SwitchParameter

Shared 매개 변수는 공유 사서함을 만들도록 지정합니다. 공유 사서함은 여러 사용자가 로그온할 수 있는 사서함입니다. 이 사서함은 로그온할 수 있는 사용자와 연결되지 않고 사용하지 않는 사용자 계정과 연결됩니다.

이 매개 변수는 공유 사서함을 만드는 경우에만 필요합니다.

UserPrincipalName

필수

System.String

UserPrincipalName 매개 변수는 이 사서함에 대한 UPN(사용자 이름)을 지정합니다. 이 이름은 사용자의 로그온 이름입니다. UPN은 사용자 이름과 접미사로 구성됩니다. 일반적으로 접미사는 사용자 계정이 있는 도메인 이름입니다.

ActiveSyncMailboxPolicy

선택

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

ActiveSyncMailboxPolicy 매개 변수는 만드는 사서함에서 사용하도록 설정할 사서함 정책을 지정합니다. 이 매개 변수를 지정하지 않을 경우 기본 사서함 정책이 사용됩니다.

Alias

선택

System.String

Alias 매개 변수는 만들려는 사용자의 전자 메일 별칭을 지정합니다.

별칭은 공백 없이 마침표로 구분된 문자 조합을 사용할 수 있으며 특수 문자는 사용할 수 없습니다.

Confirm

선택

System.Management.Automation.SwitchParameter

Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다.

DisplayName

선택

System.String

DisplayName 매개 변수는 이 사서함으로 만든 새 사용자의 표시 이름을 지정합니다. DisplayName받는 사람 구성 아래의 Exchange 관리 콘솔에 나타나는 이름입니다. DisplayName은 사용자 일반 속성 탭의 Active Directory 사용자 및 컴퓨터에도 나타납니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

DomainController 매개 변수는 이 구성 변경을 Active Directory에 기록하는 데 사용할 도메인 컨트롤러를 지정합니다. 사용하려는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 사용합니다.

FirstName

선택

System.String

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

Initials

선택

System.String

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

LastName

선택

System.String

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

LinkedCredential

선택

System.Management.Automation.PSCredential

LinkedCredential 매개 변수는 LinkedDomainController 매개 변수로 지정된 도메인 컨트롤러에 액세스하는 데 사용할 자격 증명을 지정합니다. 이 매개 변수는 연결된 사서함을 사용할 수 있더라도 선택입니다.

ManagedFolderMailboxPolicy

선택

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

ManagedFolderMailboxPolicy 매개 변수는 만드는 사서함에서 사용하도록 설정할 관리되는 폴더 사서함 정책을 지정하는 매개 변수입니다.

ManagedFolderMailboxPolicyAllowed

선택

System.Management.Automation.SwitchParameter

ManagedFolderMailboxPolicyAllowed 매개 변수는 Outlook 2007보다 이전 버전의 Microsoft Outlook을 사용하는 전자 메일 클라이언트에 대한 메시징 레코드 관리 기능이 지원되지 않는다는 경고를 무시합니다. 관리되는 폴더 사서함 정책이 ManagedFolderMailboxPolicy 매개 변수를 사용하는 사서함에 할당된 경우 ManagedFolderMailboxPolicyAllowed가 사용되지 않는 한 기본적으로 경고가 나타납니다.

참고

Outlook 2003 서비스 팩 3 클라이언트가 지원되지만 제한된 메시징 레코드 관리 기능을 제공합니다.

OrganizationalUnit

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 매개 변수는 사용자가 만들어지는 컨테이너를 지정합니다.

ResetPasswordOnNextLogon

선택

System.Boolean

$true로 설정된 경우 다음에 사용자가 로그온할 때 ResetPasswordOnNextLogon 매개 변수는 Password 매개 변수의 암호를 재설정해야 합니다.

SamAccountName

선택

System.String

SamAccountName 매개 변수는 Microsoft Windows NT 4.0, Windows 95, Windows 98 및 LAN Manager와 같은 이전 버전의 운영 체제에서 실행되는 클라이언트와 서버를 지원하는 데 사용되는 로그온 이름을 지정합니다. 이전 클라이언트를 지원하기 위해 이 특성은 20자 미만이어야 합니다.

이 매개 변수를 지정하지 않으면 Active Directory가 사용자 이름을 기반으로 SAMAccountName을 자동으로 만듭니다.

TemplateInstance

선택

System.Management.Automation.PSObject

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

UseRusServer

선택

System.String

note참고:
이 매개 변수는 Exchange 2007 SP2에서만 사용할 수 있습니다.

UseRusServer 매개 변수는 주소 목록 서비스를 실행 중인 지정된 사서함 서버를 사용하여 사서함 및 Active Directory 사용자 특성을 가져와 설정하도록 명령에 지시합니다.

주소 목록 서비스는 Exchange 시스템 수행자 서비스의 구성 요소로, Active Directory에서 Exchange 관련 특성 값을 만들어 유지 관리합니다. 주소 목록 서비스를 통해 주소 목록 구성원 및 전자 메일 주소 같은 특정 정보를 사용하여 도메인의 받는 사람 개체를 업데이트할 수 있습니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다.

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

첫 번째 예제는 Active Directory에서 Chris Ashton이라는 사용자를 만들고 해당 사용자의 사서함을 만드는 방법을 보여줍니다. 사서함은 Mailbox Database 1의 Storage Group 1에 있습니다. 다음 로그온 시 암호를 재설정해야 합니다. 초기 암호 값을 설정하기 위해 이 예제에서는 $password라는 변수를 만들고, 암호를 입력하라는 메시지를 표시하고, SecureString 개체로 변수에 해당 암호를 할당합니다.

두 번째 예제는 Active Directory에서 사용자를 만드는 방법과 회의실용 리소스 사서함을 보여줍니다. 리소스 사서함은 Mailbox Database 1의 Storage Group 1에 있습니다. 다음 로그온 시 암호를 재설정해야 합니다. 초기 암호 값이 지정되지 않았기 때문에 Exchange 관리 셸이 해당 값을 입력하라는 메시지를 표시합니다.

$password = Read-Host "Enter password" -AsSecureString
New-mailbox -UserPrincipalName chris@contoso.com -alias chris -database "Storage Group 1\Mailbox Database 1" -Name ChrisAshton -OrganizationalUnit Users -password $password -FirstName Chris -LastName Ashton -DisplayName "Chris Ashton" -ResetPasswordOnNextLogon $true

New-Mailbox -UserPrincipalName confmbx@contoso.com -alias confmbx -name ConfRoomMailbox -database "Storage Group 1\Mailbox Database 1" -OrganizationalUnit Users -Room -ResetPasswordOnNextLogon $true