Remove-Mailbox
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Командлет Remove-Mailbox используется для удаления почтовых ящиков и связанных учетных записей пользователей.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Remove-Mailbox
[-Identity] <MailboxIdParameter>
[-Permanent <Boolean>]
[-Arbitration]
[-AuditLog]
[-AuxAuditLog]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-IgnoreDefaultScope]
[-IgnoreLegalHold]
[-Migration]
[-PublicFolder]
[-RemoveArbitrationMailboxWithOABsAllowed]
[-RemoveLastArbitrationMailboxAllowed]
[-SupervisoryReviewPolicy]
[-WhatIf]
[<CommonParameters>]
Remove-Mailbox
-Database <DatabaseIdParameter>
-StoreMailboxIdentity <StoreMailboxIdParameter>
[-Arbitration]
[-AuditLog]
[-AuxAuditLog]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-IgnoreDefaultScope]
[-IgnoreLegalHold]
[-Migration]
[-PublicFolder]
[-RemoveArbitrationMailboxWithOABsAllowed]
[-RemoveLastArbitrationMailboxAllowed]
[-SupervisoryReviewPolicy]
[-WhatIf]
[<CommonParameters>]
Remove-Mailbox
[-Identity] <MailboxIdParameter>
[-PermanentlyDelete]
[-Confirm]
[-Force]
[-Migration]
[-PublicFolder]
[-RemoveCNFPublicFolderMailboxPermanently]
[-WhatIf]
[<CommonParameters>]
Описание
Параметр Identity используется для отсоединения почтового ящика от пользователя и удаления учетной записи пользователя. Почтовый ящик все еще существует и сохраняется до истечения периода хранения удаленных почтовых ящиков. Период хранения удаленного почтового ящика управляется свойством MailboxRetention в базе данных почтовых ящиков или в самом почтовом ящике, если свойство UseDatabaseRetentionDefaults имеет значение False.
Параметры Identity и Permanent используются для отсоединения почтового ящика от пользователя, удаления учетной записи пользователя, а также удаления почтового ящика из базы данных почтовых ящиков. Почтовый ящик не сохраняется в базе данных почтовых ящиков как отсоединенный почтовый ящик.
Командлет Disable-Mailbox отсоединяет почтовый ящик от учетной записи пользователя, но сохраняет саму учетную запись пользователя. Почтовый ящик сохраняется до истечения периода хранения удаленных почтовых ящиков для базы данных или почтового ящика, после чего почтовый ящик удаляется окончательно. Вы также можете немедленно очистить отключенный почтовый ящик с помощью параметров Database и StoreMailboxIdentity в командлете Remove-Mailbox.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Remove-Mailbox -Identity "John Rodman"
Этот пример демонстрирует, как удалить почтовый ящик и учетную запись пользователя с именем John Rodman. Почтовый ящик остается в базе данных почтовых ящиков в течение периода хранения почтового ящика, заданного для базы данных.
Пример 2
Remove-Mailbox -Identity "John Rodman" -Permanent $true
В локальной среде Exchange в этом примере удаляются почтовый ящик и учетная запись пользователя с именем John Rodman. Почтовый ящик немедленно и окончательно удаляется из базы данных почтовых ящиков.
Пример 3
$Temp = Get-Mailbox | Where {$_.DisplayName -eq 'John Rodman'}
Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid
В локальной среде Exchange в этом примере почтовый ящик Джона Родмана удаляется из базы данных почтовых ящиков после отключения почтового ящика от учетной записи пользователя. В примере командлет Get-Mailbox используется для получения значения GUID отсоединенного почтового ящика, которое необходимо параметру StoreMailboxIdentity.
Пример 4
Get-Mailbox -Identity Laura -SoftDeletedMailbox | Remove-Mailbox -PermanentlyDelete
В Exchange Online в этом примере удаляется указанный обратимо удаленный почтовый ящик.
Параметры
-Arbitration
Этот параметр доступен только в локальной среде Exchange.
Для удаления почтовых ящиков арбитража требуется параметр Арбитраж. Указывать значение для этого параметра необязательно.
Почтовые ящики арбитража — это системные почтовые ящики, которые используются для хранения различных типов системных данных и управления рабочим процессом утверждения сообщений.
Чтобы удалить почтовые ящики арбитража, используемые для хранения параметров или данных журнала аудита, не используйте этот параметр. Вместо этого используйте параметры AuditLog или AuxAuditLog.
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 |
-AuditLog
Этот параметр доступен только в локальной среде Exchange.
Параметр AuditLog необходим для удаления почтовых ящиков журнала аудита. Для этого переключателя не требуется указывать значение.
Почтовые ящики журнала аудита — это почтовые ящики арбитража, которые используются для хранения параметров журнала аудита.
Чтобы удалить другие типы почтовых ящиков арбитража, не используйте этот параметр. Вместо этого используйте параметр Арбитраж.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-AuxAuditLog
Этот параметр доступен только в локальной среде Exchange.
Параметр AuxAuditLog необходим для удаления вспомогательных почтовых ящиков журнала аудита. Указывать значение для этого параметра необязательно.
Почтовые ящики журнала аудита — это почтовые ящики арбитража, которые используются для хранения параметров журнала аудита.
Чтобы удалить другие типы почтовых ящиков арбитража, не используйте этот параметр. Вместо этого используйте параметр Арбитраж.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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, Exchange Online |
-Database
Этот параметр доступен только в локальной среде Exchange.
Параметр Database указывает базу данных Exchange, содержащую почтовый ящик, который требуется удалить. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:
- имя;
- различающееся имя (DN);
- GUID
При использовании этого параметра с параметром StoreMailboxIdentity для определения и удаления почтового ящика, он удаляется из базы данных немедленно и окончательно, поэтому его невозможно будет подключить или восстановить. Ни один из этих параметров не может использоваться с параметром Identity.
Если вы отключили почтовый ящик от связанного с ним пользователя и хотите удалить объект почтового ящика из хранилища Exchange, используйте параметры Database и StoreMailboxIdentity.
Type: | DatabaseIdParameter |
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 |
-DomainController
Этот параметр доступен только в локальной среде Exchange.
Параметр 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 |
-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, Exchange Online |
-Identity
Параметр Identity определяет удаляемый почтовый ящик. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
Этот параметр не может использоваться вместе с параметром Database.
Type: | MailboxIdParameter |
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, Exchange Online |
-IgnoreDefaultScope
Этот параметр доступен только в локальной среде Exchange.
Параметр IgnoreDefaultScope указывает команде игнорировать параметр области получателя по умолчанию для сеанса Exchange PowerShell и использовать в качестве области весь лес. Указывать значение для этого параметра необязательно.
Этот параметр позволяет команде получать доступ к объектам Active Directory, которые в настоящее время недоступны в области по умолчанию, но также вводит следующие ограничения:
- При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
- При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
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 |
-IgnoreLegalHold
Этот параметр доступен только в локальной среде Exchange.
Параметр IgnoreLegalHold игнорирует юридическое состояние удержания пользователя. Указывать значение для этого параметра необязательно.
При отключении или удалении пользователя облачный почтовый ящик пользователя, который находится на удержании по закону, также отключается или удаляется.
После отключения или удаления почтового ящика вы не сможете включить его в поиск обнаружения. Если отключить почтовый ящик, этот ящик будет отключен от учетной записи пользователя. Отключенные и удаленные почтовые ящики окончательно удаляются из базы данных почтовых ящиков по истечении срока хранения удаленных почтовых ящиков. Однако можно также удалить почтовый ящик и немедленно очистить его из базы данных почтовых ящиков. Перед отключением или удалением почтового ящика, который находится на удержании по закону, обратитесь к юридическому отделу или отделу кадров вашей организации.
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 |
-Migration
Параметр Миграция необходим для удаления почтовых ящиков миграции. Указывать значение для этого параметра необязательно.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Permanent
Этот параметр доступен только в локальной среде Exchange.
Параметр Permanent указывает, следует ли окончательно удалить почтовый ящик из базы данных почтовых ящиков. Допустимые значения:
- $true: почтовый ящик немедленно и окончательно удаляется (очищается). Вы не сможете повторно подключить почтовый ящик или восстановить его.
- $false: почтовый ящик отключен и сохраняется до истечения срока хранения удаленного почтового ящика. Вы можете повторно подключить почтовый ящик или восстановить его до истечения периода хранения удаленных почтовых ящиков. Это значение используется по умолчанию.
Type: | Boolean |
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 |
-PermanentlyDelete
Этот параметр доступен только в облачной службе.
Переключатель PermanentlyDelete немедленно и безвозвратно удаляет (очищает) почтовый ящик, что предотвращает восстановление или восстановление почтового ящика. Указывать значение для этого параметра необязательно.
Примечания.
- Этот параметр работает только в почтовых ящиках, которые уже были удалены, но по-прежнему могут быть восстановлены (называемые обратимо удаленными почтовыми ящиками). Используйте командлет Get-Mailbox, чтобы определить обратимо удаленный почтовый ящик, а затем передать результаты в командлет Remove-Mailbox, как показано в примере 4 в этом разделе.
- Этот параметр не работает в обратимо удаленных почтовых ящиках, которые находятся в In-Place удержании или удержании для судебного разбирательства (известных как неактивные почтовые ящики).
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PublicFolder
Для удаления почтовых ящиков общедоступных папок требуется параметр PublicFolder. Указывать значение для этого параметра необязательно.
Почтовые ящики общедоступных папок созданы специально для хранения иерархии и содержимого общедоступных папок.
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, Exchange Online |
-RemoveArbitrationMailboxWithOABsAllowed
Этот параметр доступен только в локальной среде Exchange.
Параметр RemoveArbitrationMailboxWithOABsAllowed указывает, следует ли пропустить проверки автономных адресных книг (OAB) в указанном арбитражном почтовом ящике, который удаляется. Для этого переключателя не требуется указывать значение.
При использовании этого параметра почтовый ящик арбитража удаляется, даже если в нем есть автономные адресные книги.
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 |
-RemoveCNFPublicFolderMailboxPermanently
Этот параметр доступен только в облачной службе.
{{ Fill RemoveCNFPublicFolderMailboxPermanently Description }}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-RemoveLastArbitrationMailboxAllowed
Этот параметр доступен только в локальной среде Exchange.
Параметр RemoveLastArbitrationMailboxAllowed указывает, удалить ли указанный почтовый ящик, даже если этой последний арбитражный почтовый ящик в организации. Для этого переключателя не требуется указывать значение.
При удалении последнего арбитражного почтового ящика в организации невозможно создавать группы рассылки или пользоваться функцией управляемых получателей.
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 |
-StoreMailboxIdentity
Этот параметр доступен только в локальной среде Exchange.
Параметр StoreMailboxIdentity указывает почтовый ящик, который требуется удалить. При использовании этого параметра почтовый ящик определяется по его значению MailboxGUID. Значение GUID можно найти с помощью командлета Get-Mailbox или Get-MailboxStatistics.
При использовании этого параметра с параметром Database для определения и удаления почтового ящика, он удаляется из базы данных немедленно и окончательно, поэтому его невозможно будет подключить или восстановить. Вы не можете использовать ни один из этих параметров с помощью параметра Identity.
Если вы отключили почтовый ящик от связанного с ним пользователя и хотите удалить объект почтового ящика из хранилища Exchange, используйте параметры Database и StoreMailboxIdentity.
Type: | StoreMailboxIdParameter |
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 |
-SupervisoryReviewPolicy
Этот параметр доступен только в локальной среде Exchange.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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, Exchange Online |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.