Connect-Mailbox

Синтаксис

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
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
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 (также известный как псевдоним почты) для получателя. Это значение определяет получателя как объект с включенной поддержкой почты и не следует путать с несколькими адресами электронной почты для одного и того же получателя (прокси-адреса). Получатель может иметь только одно значение псевдонима.

Значение псевдонима может содержать буквы, числа и следующие символы: !, #, $, %, &, ', * +, -, /, =, ?, ^, _ ` , {, }, |и ~. Периоды (.) разрешены, но каждый период должен быть уселен другими допустимыми символами (например, help.desk). Также разрешены символы Юникода от U+00A1 до U+00FF. Максимальная длина значения псевдонима составляет 64 символа.

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

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

  • Получатели с учетными записями пользователей (например, почтовые ящики пользователей и почтовые пользователи): используется левая сторона параметра MicrosoftOnlineServicesID или UserPrincipalName. Например, helpdesk@contoso.com в helpdesk значения свойства Alias.
  • Получатели без учетных записей пользователей (например, почтовые ящики помещений, почтовые контакты и группы рассылки): используется значение параметра Name. Пробелы удаляются, а неподтвержденные символы преобразуются в вопросии (?).

При изменении значения псевдонима существующего получателя основной адрес электронной почты автоматически обновляется только в тех средах, где к получателю налагаются политики адресов электронной почты (свойство EmailAddressPolicyEnabled для получателя имеет значение True).

Параметр Alias никогда не создает и не обновляет основной адрес электронной почты почтового контакта или почтового пользователя.

Type:String
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Confirm

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

  • Деструктивные командлеты (например, Remove-* командлеты) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Для этих cmdlets можно пропустить запрос на подтверждение, используя следующий синтаксис: -Confirm:$false .
  • Большинство других командлетов (например, New-* и Set-*командлеты) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

Параметр Identity указывает почтовый ящик, который вы хотите подключить к учетной записи пользователя. Этот параметр не указывает объект Active Directory. Для указания почтового ящика можно использовать следующие значения:

  • Краткое имя
  • GUID
  • LegacyExchangeDN

Этот параметр используется с параметром Database для указания почтового ящика, который вы хотите подключить.

Type:StoreMailboxIdParameter
Position:1
Default value:None
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
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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Room

Для подключения почтовых ящиков помещений требуется коммутатор room. С этим параметром не нужно указывать значение.

Почтовые ящики помещений — это почтовые ящики ресурсов, связанные с определенным расположением (например, конференц-залами).

Type:SwitchParameter
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ValidateOnly

Параметр ValidateOnly указывает командлету оценить условия и требования, необходимые для выполнения операции, и уведомляет, будет ли эта операция выполнена успешно. Если используется параметр ValidateOnly, изменения не будут выполнены.

Type:SwitchParameter
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Типы входных данных, поддерживаемые этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы входных данных" для командлета пустое, этот командлет не поддерживает ввода данных.

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

Типы возвращаемых данных, или типы выходных данных, которые поддерживаются этим командлетом, см. в статье Типы входных и выходных данных для командлетов. Если поле "Типы выходных данных" пустое, командлет не возвращает данные.