Connect-Mailbox

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Connect-Mailbox コマンドレットを使用して、切断されたメールボックスを、まだメールボックスを持っていない既存のユーザーアカウントに接続します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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>]

説明

メールボックスを既存のユーザーアカウントにリンクすると、そのユーザーアカウントは、このメールボックスおよびメールボックス内のすべてのメールに対するフルアクセスが可能となります。

User パラメーターを使用してユーザーアカウントを指定する場合、正しいアカウントを指定するよう注意してください。 User パラメーターを使用しない場合は、ValidateOnly スイッチを使用して、どのユーザーアカウントにメールボックスが接続されるかを確認することをお勧めします。

Disconnect-Mailbox コマンドレットはありません。 Disable-Mailbox または Remove-Mailbox コマンドレットを使用して、効率的にメールボックスをユーザーアカウントから切断できます。

Disable-Mailbox コマンドレットを使用する場合:

ユーザーアカウントからメールボックスを切断します。
削除済みメールボックスの保存期間に従って、メールボックスは永久に削除されるときまで無効な状態で保持されます。
ユーザーアカウントを保持しますが、アカウントから Exchange 属性を削除します。

Remove-mailbox コマンドレットを使用する場合:

ユーザーアカウントからメールボックスを切断します。
削除済みメールボックスの保存期間に従って、メールボックスは永久に削除されるまで無効な状態で保持されます (Permanent または StoreMailboxIdentity パラメーターを使用して、即時にデータベースからメールボックスを削除する場合を除きます)。
ユーザーアカウントを削除します。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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

アドレス帳ポリシーの詳細については、「Address book policies in Exchange Server (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 値を 1 つだけ持つことができます。最大の長さは 64 文字です。

Alias 値には、文字、数字、および次の文字を含めることができます。

!、#、%、*、+、-、/、=、?、^、_、~。
$、 &、'、'、{、}、|は、エスケープする必要があります (たとえば -Alias what`'snew) か、単一引用符で囲まれた値全体 (例: -Alias 'what'snew')。この & 文字は、Azure AD Connect 同期の Alias 値ではサポートされていません。
ピリオド (.) は、他の有効な文字 (例: help.desk) で囲む必要があります。
Unicode 文字 U+00A1 から U+00FF。

メールアドレスを指定せずに受信者を作成すると、指定した Alias 値を使用してプライマリメールアドレス (alias@domain) が生成されます。サポートされている Unicode 文字は、最も適した US-ASCII テキスト文字にマッピングされます。たとえば、U+00F6 (ö) はプライマリメールアドレスでに oe 変更されます。

受信者の作成時に Alias パラメーターを使用しない場合、次のように別の必須パラメーターの値が Alias プロパティの値として使用されます。

ユーザーアカウントのある受信者 (たとえば、ユーザーメールボックスやメールユーザー): MicrosoftOnlineServicesID または UserPrincipalName パラメーターの左側が使用されます。たとえば、 helpdesk@contoso.onmicrosoft.com Alias プロパティ値 helpdeskになります。
ユーザーアカウントのない受信者 (たとえば、会議室メールボックス、メール連絡先、配布グループ): Name パラメーターの値が使用されます。スペースは削除されます。サポートされていない文字は疑問符 (?) に変換されます。

既存の受信者の Alias の値を変更した場合、プライマリ電子メールアドレスは、受信者が電子メールアドレスポリシーに従う必要がある (受信者に対して 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 スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

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 からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (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

機器メールボックスを接続するには、機器スイッチが必要です。このスイッチで値を指定する必要はありません。

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 コマンドレットが必要です。このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(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 スイッチは、操作の実行に必要な状態および要件を評価して、操作が成功したか失敗したかを通知するようにコマンドレットに指示します。このスイッチで値を指定する必要はありません。

このスイッチを使用しても変更は行われません。

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

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。

Connect-Mailbox

構文

説明

例

例 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

入力

出力

フィードバック

フィードバック

その他のリソース