Connect-Mailbox

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Connect-Mailbox cmdlet을 사용하여 연결이 끊긴 사서함을 사서함이 없는 기존 사용자 계정에 연결합니다.

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

Syntax

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Equipment]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       -LinkedDomainController <Fqdn>
       -LinkedMasterAccount <UserIdParameter>
       [-LinkedCredential <PSCredential>]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Room]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Shared]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-ValidateOnly]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-WhatIf]
       [<CommonParameters>]

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-User <UserIdParameter>]
       [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
       [-AllowLegacyDNMismatch]
       [-Archive]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-WhatIf]
       [<CommonParameters>]

Description

사서함을 기존 사용자 계정에 연결하면 해당 사용자 계정은 사서함 및 사서함의 모든 메일에 대해 모든 권한을 갖게 됩니다.

User 매개 변수를 사용하여 사용자 계정을 지정하는 경우 올바른 계정을 지정해야 합니다. User 매개 변수를 사용하지 않는 경우 ValidateOnly 스위치를 사용하여 사서함이 연결하도록 할 사용자 계정을 확인하는 것이 좋습니다.

Disconnect-Mailbox cmdlet은 없습니다. Disable-Mailbox 또는 Remove-Mailbox cmdlet을 사용하면 사용자 계정에서 사서함 연결을 실질적으로 끊을 수 있습니다.

Disable-Mailbox cmdlet을 사용하여 다음 작업을 수행합니다.

사용자 계정에서 사서함 연결을 끊습니다.
삭제된 사서함 보존 기간에 따라 사서함을 영구적으로 삭제되기 전까지 사용할 수 없는 상태로 유지합니다.
사용자 계정을 유지하지만 계정에서 Exchange 특성을 제거합니다.

Remove-Mailbox cmdlet을 사용하여 다음 작업을 수행합니다.

사용자 계정에서 사서함 연결을 끊습니다.
Permanent 또는 StoreMailboxIdentity 매개 변수(데이터베이스에서 사서함을 즉시 삭제함)를 사용하는 경우를 제외하고 삭제된 사서함 보존 기간에 따라 사서함을 영구적으로 삭제되기 전까지 사용할 수 없는 상태로 유지합니다.
사용자 계정을 제거합니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Connect-Mailbox -Database "Mailbox Database" -Identity "John Evans"

이 예에서는 연결이 끊긴 John Evans의 사서함을 연결합니다. 사서함을 연결할 사용자는 지정하지 않으므로 명령은 고유하게 일치하는 사용자 개체를 찾습니다.

예 2

Connect-Mailbox -Identity "John Evans" -Database "MBXDB02" -LinkedDomainController FabrikamDC01 -LinkedMasterAccount john@fabrikam.com

이 예에서는 연결된 사서함을 연결합니다.

예 3

Connect-Mailbox -Identity "CAR001" -Database "MBXResourceDB" -Equipment -User "CAR001"

이 예에서는 장비 사서함을 연결합니다.

예 4

Connect-Mailbox -Identity "ConfRm212" -Database "MBXResourceDB" -Room -User "Conference Room 212"

이 예에서는 대화방 사서함을 연결합니다.

매개 변수

-ActiveSyncMailboxPolicy

ActiveSyncMailboxPolicy 매개 변수는 사서함에 적용되는 모바일 장치 사서함 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

이름
DN(고유 이름)
GUID

이 매개 변수를 사용하지 않으면 기본 모바일 장치 사서함 정책이 사용됩니다.

Type:	MailboxPolicyIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AddressBookPolicy

AddressBookPolicy 매개 변수는 사서함에 적용되는 주소록 정책을 지정합니다. 주소록 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

이름
DN(고유 이름)
GUID

주소록 정책에 대한 자세한 내용은 Exchange Server 주소록 정책을 참조하세요.

Type:	AddressBookMailboxPolicyIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Alias

Alias 매개 변수는 받는 사람의 Exchange 별칭(메일 애칭이라고도 함)을 지정합니다. 이 값은 받는 사람을 메일 사용이 가능한 개체로 식별하며, 동일한 받는 사람에 대한 여러 전자 메일 주소(프록시 주소라고도 함)를 혼동하지 않아야 합니다. 받는 사람은 Alias 값을 하나만 가질 수 있습니다. 최대 길이는 64자입니다.

별칭 값에는 문자, 숫자 및 다음 문자가 포함될 수 있습니다.

!, #, %, *, +, -, /, =, ?, ^, _, ~.
$, &, ', ', {, }및 | 이스케이프(예: -Alias what`'snew) 또는 작은따옴표로 묶인 전체 값(예: -Alias 'what'snew')을 이스케이프해야 합니다. 문자는 & Azure AD Connect 동기화에 대한 별칭 값에서 지원되지 않습니다.
마침표(.)는 다른 유효한 문자(예: help.desk)로 묶어야 합니다.
유니코드 문자 U+00A1에서 U+00FF로

전자 메일 주소를 지정하지 않고 받는 사람을 만들 때 지정한 별칭 값은 기본 전자 메일 주소(alias@domain)를 생성하는 데 사용됩니다. 지원되는 유니코드 문자는 가장 적합한 US-ASCII 텍스트 문자에 매핑됩니다. 예를 들어 U+00F6(ö)은 기본 전자 메일 주소에서 로 변경됩니다 oe .

받는 사람을 만들 때 Alias 매개 변수를 사용하지 않는 경우 별칭 속성 값에 다른 필수 매개 변수의 값이 사용됩니다.

사용자 계정(예: 사용자 사서함 및 메일 사용자)이 있는 받는 사람: MicrosoftOnlineServicesID 또는 UserPrincipalName 매개 변수의 왼쪽이 사용됩니다. 예를 들어 별 helpdesk@contoso.onmicrosoft.com 칭 속성 값 helpdesk이 입니다.
사용자 계정이 없는 받는 사람(예: 회의실 사서함, 메일 연락처 및 메일 그룹): Name 매개 변수 값이 사용됩니다. 공백이 제거되고 지원되지 않는 문자가 물음표(?)로 변환됩니다.

기존 받는 사람의 별칭 값을 수정하는 경우 받는 사람에게 전자 메일 주소 정책이 적용되는 환경에서만 기본 전자 메일 주소가 자동으로 업데이트됩니다(받는 사람의 경우 EmailAddressPolicyEnabled 속성은 True임).

Alias 매개 변수는 메일 연락처 또는 메일 사용자의 기본 전자 메일 주소를 생성하거나 업데이트하지 않습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AllowLegacyDNMismatch

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Archive

Archive 스위치는 관련 보관 사서함을 연결할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

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

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Database

Database 매개 변수는 연결하려는 사서함이 포함된 Exchange 데이터베이스를 지정합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

이름
DN(고유 이름)
GUID

연결할 사서함을 지정하려면 이 매개 변수를 Identity 매개 변수와 함께 사용합니다.

Type:	DatabaseIdParameter
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Equipment

장비 사서함을 연결하려면 장비 스위치가 필요합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

장비 사서함은 특정 위치(예: 차량 또는 컴퓨터)와 연결되지 않은 리소스 사서함입니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Force

강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 매개 변수는 사용자 계정에 연결할 사서함을 지정합니다. 이 매개 변수는 Active Directory 개체를 지정하지 않습니다. 다음 값을 사용하여 사서함을 식별할 수 있습니다.

표시 이름
GUID
LegacyExchangeDN

연결할 사서함을 지정하려면 이 매개 변수를 Database 매개 변수와 함께 사용합니다.

Type:	StoreMailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedCredential

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

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedDomainController

LinkedDomainController 매개 변수는 사서함이 연결된 사서함인 경우 사용자 계정이 있는 포리스트의 도메인 컨트롤러를 지정합니다. 사용자 계정이 있는 포리스트의 도메인 컨트롤러를 사용하여 LinkedMasterAccount 매개 변수에서 지정한 계정에 대한 보안 정보를 가져오는 데 사용됩니다. 사용하려는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 이 매개 변수의 값으로 사용합니다.

이 매개 변수는 연결된 사서함에 연결하는 경우에만 필요합니다.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedMasterAccount

LinkedMasterAccount 매개 변수는 이 사서함이 연결된 사서함인 경우 사용자 계정이 있는 포리스트의 마스터 계정을 지정합니다. 마스터 계정은 사서함이 연결된 계정입니다. 마스터 계정은 사서함에 대한 액세스 권한을 부여합니다. 이 매개 변수는 연결된 사서함을 만드는 경우에만 필요합니다. 마스터 계정을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예: 예를 들면 다음과 같습니다.

이름
DN(고유 이름)
DN(고유 이름)
GUID

이 매개 변수는 연결된 사서함에 연결하는 경우에만 필요합니다.

Type:	UserIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ManagedFolderMailboxPolicy

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:	MailboxPolicyIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ManagedFolderMailboxPolicyAllowed

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RetentionPolicy

RetentionPolicy 매개 변수는 사서함에 적용되는 보존 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

이름
DN(고유 이름)
GUID

보존 정책은 항목을 보존할 기간을 결정하기 위해 사서함 폴더와 메일 항목에 적용되는 태그로 구성됩니다.

Type:	MailboxPolicyIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Room

회의실 사서함을 연결하려면 회의실 스위치가 필요합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

회의실 사서함은 특정 위치(예: 회의실)와 연결된 리소스 사서함입니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Shared

공유 사서함을 연결하려면 공유 스위치가 필요합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

공유 사서함은 여러 사용자가 로그온하여 사서함 콘텐츠에 액세스할 수 있는 사서함입니다. 이 사서함은 로그온할 수 있는 사용자와 연결되지 않습니다. 비활성화된 사용자 계정과 연결됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-User

User 매개 변수는 사서함을 연결하려는 Active Directory의 사용자 개체를 지정합니다. 사용자를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예: 예를 들면 다음과 같습니다.

이름
DN(고유 이름)
DN(고유 이름)
GUID

이 매개 변수를 사용하지 않으면 명령은 사서함의 LegacyExchangeDN 및 DisplayName 속성 값을 사용하여 같은 값을 포함하는 사용자 계정을 찾습니다. 고유하게 일치하는 사용자 계정을 찾을 수 없으면 사서함을 연결하지 않습니다.

Type:	UserIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ValidateOnly

ValidateOnly 스위치는 작업을 수행하는 데 필요한 조건과 요구 사항을 평가하도록 cmdlet에 지시한 후 작업의 성공 여부를 보고합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용할 때는 변경되지 않습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

입력

Input types

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

출력

Output types

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

Connect-Mailbox

Syntax

Description

예제

예 1

예 2

예 3

예 4

매개 변수

-ActiveSyncMailboxPolicy

-AddressBookPolicy

-Alias

-AllowLegacyDNMismatch

-Archive

-Confirm

-Database

-DomainController

-Equipment

-Force

-Identity

-LinkedCredential

-LinkedDomainController

-LinkedMasterAccount

-ManagedFolderMailboxPolicy

-ManagedFolderMailboxPolicyAllowed

-RetentionPolicy

-Room

-Shared

-User

-ValidateOnly

-WhatIf

입력

출력

피드백

피드백

추가 리소스