Поделиться через

Remove-Mailbox

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2007-06-28

Командлет Remove-Mailbox используется для удаления из службы каталогов Active Directory учетной записи пользователя, связанной с определенным почтовым ящиком, и для обработки связанного отсоединенного почтового ящика, как предписывается заданными параметрами.

Синтаксис

Remove-Mailbox -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Permanent <$true | $false>] [-WhatIf [<SwitchParameter>]]

Remove-Mailbox -Database <DatabaseIdParameter> -StoreMailboxIdentity <StoreMailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Подробное описание

Командлет Remove-Mailbox удаляет из Active Directory учетную запись пользователя, связанную с конкретным почтовым ящиком, а затем обрабатывает связанный отключенный почтовый ящик, как предписано заданными параметрами.

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

Используйте параметры Identity и Permanent, чтобы отсоединить почтовый ящик от пользователя, удалить объект пользователя из Active Directory, а также удалить объект почтового ящика из базы данных Exchange. Объект почтового ящика в этом случае не сохраняется в базе данных Exchange как отсоединенный почтовый ящик.

Используйте параметры Database и StoreMailboxIdentity, чтобы удалить объект почтового ящика из базы данных Exchange. В этом случае объект почтового ящика уже был отсоединен от пользователя. Например, при выполнении командлета Disable-Mailbox объект почтового ящика Exchange сохраняется, но отключается от объекта пользователя Active Directory. Параметры Database и StoreMailboxIdentity можно использовать для удаления этого отсоединенного объекта почтового ящика.

Для выполнения командлета Remove-Mailbox используемой учетной записи необходимо делегировать следующие роли:

  • роль администратора получателей Exchange;

  • роль оператора учета для соответствующих контейнеров Active Directory.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр Обязательный Тип Описание

Database

Обязательный

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

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

  • GUID

  • Имя базы данных

  • имя сервера\имя базы данных

  • Имя сервера\группа хранения\имя базы данных

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

Данный параметр должен применяться совместно с параметром StoreMailboxIdentity . Параметр Identity нельзя использовать с параметром Database. Если почтовый ящик отсоединен от связанного с ним пользователя, и нужно удалить объект почтового ящика из хранилища Exchange, используйте параметры Database и StoreMailboxIdentity.

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • ADObjectID

  • Различающееся имя (DN)

  • Различающееся имя (DN) старой версии Exchange, GUID

  • Домен\Имя_учетной_записи

  • имя участника-пользователя (UPN)

  • адрес электронной почты

  • Псевдоним

Параметр Identity нельзя использовать с параметром Database.

StoreMailboxIdentity

Обязательный

Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter

Параметр StoreMailboxIdentity определяет удаляемый объект почтового ящика. Параметр StoreMailboxIdentity используется вместе с параметром Database для удаления объекта почтового ящика из базы данных Exchange. Если почтовый ящик отсоединен от связанного с ним пользователя, и нужно удалить объект почтового ящика из хранилища Exchange, используйте параметры Database и StoreMailboxIdentity.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

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

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Параметр DomainController указывает контроллер домена, который записывает изменение конфигурации в Active Directory. Используйте полное доменное имя нужного контроллера домена.

IgnoreDefaultScope

Необязательный

System.Management.Automation.SwitchParameter

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

  • Использовать параметр DomainController нельзя. Команда будет использовать подходящий сервер глобального каталога автоматически.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

Permanent

Необязательный

System.Boolean

Параметр Permanent при использовании вместе с параметром Identity отсоединяет почтовый ящик от пользователя, удаляет объект пользователя из Active Directory, а также удаляет объект почтового ящика из базы данных Exchange. Двумя возможными значениями этого параметра являются $true или $false. Значением по умолчанию является $false.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

Исключения

Исключения Описание

 

Пример

Первый пример показывает, как отсоединить почтовый ящик пользователя Джона Пиплза (john) от учетной записи пользователя и удалить объект почтового ящика из Active Directory. В конце периода хранения почтового ящика, заданного для базы данных этого опчтового ящика, он остается в базе данных Exchange.

Второй пример показывает, как отсоединить почтовый ящик пользователя Джона Пиплза (john) от учетной записи пользователя, удалить объект почтового ящика из Active Directory и удалить почтовый ящик из хранилища Exchange.

Третий пример демонстрирует, как удалить почтовый ящик Джона Пиплза (john) из базы данных Exchange, в предположении, что почтовый ящик был уже отсоединен от пользователя. В данном примере показано, как использовать командлет Get-MailboxStatisticse для получения значения GUID почтового ящика с помощью отображаемого имени отключенного почтового ящика. Это значение необходимо для параметра StoreMailboxIdentity командлета Remove-Mailbox.

Remove-Mailbox -Identity contoso\john
Remove-Mailbox -Identity contoso\john -Permanent $true
$Temp = Get-MailboxStatistics | Where {$_.DisplayName -eq 'John Peoples'}
Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid