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

Подробнее о политиках адресных книг см. в разделе Политики адресных книг в 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 может содержать буквы, цифры и следующие символы:

!, #, %, *, +, -, /, =, ?, ^, _, и ~.
$, &, ', ', {, }и | должны быть экранированы (например -Alias what`'snew, ) или все значение заключено в одинарные кавычки (например, -Alias 'what'snew'). Символ & не поддерживается в значении Псевдоним для синхронизации Azure AD Connect.
Точки (.) должны быть окружены другими допустимыми символами (например, help.desk).
Символы Юникода от U+00A1 до U+00FF.

Если при создании получателя не указать электронный адрес, то заданное значение Alias будет использовано для создания основного электронного адреса (alias@domain). Поддерживаемые символы Юникода сопоставляются с наиболее подходящими текстовыми символами US-ASCII. Например, U+00F6 (ö) изменяется на oe в основном адресе электронной почты.

Если при создании получателя не использовать параметр Alias, то в качестве значения свойства Alias будет использовано значение другого обязательного параметра:

Для получателей с учетными записями пользователей (например, почтовые ящики пользователей и почтовые пользователи) используется левая часть параметра MicrosoftOnlineServicesID или параметр UserPrincipalName. Например, helpdesk@contoso.onmicrosoft.com возвращает значение helpdeskсвойства Alias .
Для получателей без учетных записей пользователей (например, почтовые ящики переговорных комнат, почтовые контакты и группы рассылки) используется значение параметра 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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

Деструктивные командлеты (например, командлеты 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. Вы определяете контроллер домена по его полному доменному имени (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. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

Переключатель 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

Входные данные

Выходные данные

Обратная связь

Обратная связь

Дополнительные ресурсы