New-MailboxRestoreRequest

Модуль:

ExchangePowerShell

Применяется к:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Командлет New-MailboxRestoreRequest используется для восстановления отключенного или удаленного (с возможностью восстановления) почтового ящика. Этот командлет запускает процесс перемещение контента из почтового ящика (удаленного, отключенного или просто любого почтового ящика в базе данных восстановления) в подключенный основной или архивный почтовый ящик.

Свойства, используемые для поиска отключенных почтовых ящиков и восстановления почтового ящика, отличаются в Exchange Server и Exchange Online. Дополнительные сведения о Exchange Online см. в статье Восстановление неактивного почтового ящика.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

New-MailboxRestoreRequest
   -SourceDatabase <DatabaseIdParameter>
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxOrMailUserIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-MRSServer <Fqdn>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-SourceRootFolder <String>]
   [-SuspendComment <String>]
   [-Suspend]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-WhatIf]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceEndpoint <MigrationEndpointIdParameter>
   -SourceExchangeGuid <Guid>
   -SourceTenant <SmtpDomain>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-CrossTenantRestore]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-SuspendComment <String>]
   [-Suspend]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceDatabase <DatabaseIdParameter>
   -SourceStoreMailbox <StoreMailboxIdParameter>>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxOrMailUserIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

New-MailboxRestoreRequest
   -RemoteDatabaseGuid <Guid>
   -RemoteHostName <Fqdn>
   -RemoteRestoreType <RemoteRestoreType>
   -RemoteCredential <PSCredential>
   -SourceMailbox <MailboxLocationIdParameter>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceIsArchive]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

Описание

При перемещении почтовых ящиков из одной базы данных в другую Exchange не полностью удаляет почтовый ящик из базы данных-источника сразу после завершения перемещения. Вместо этого почтовый ящик в исходной базе данных почтовых ящиков переводится в состояние удаления с возможностью восстановления, что делает данные в почтовом ящике доступными при восстановлении почтового ящика с помощью новых командлетов MailboxRestoreRequest. Удаленные таким образом почтовые ящики сохраняются в исходной базе данных, пока не истечет период сохранения удаленных почтовых ящиков или не будет использован командлет Remove-StoreMailbox, очищающий почтовый ящик.

Чтобы просмотреть почтовые ящики, удаленные с возможностью восстановления, запустите командлет Get-MailboxStatistics в базе данных и просмотрите результаты, поле DisconnectReason которых имеет значение SoftDeleted. Дополнительные сведения см. в примере 1 ниже в этой статье.

Почтовый ящик помечается как отключенный почти сразу после выполнения команд Disable-Mailbox и Remove-Mailbox.

Почтовый ящик не будет помечаться как Отключенный, пока служба хранилища сведений Microsoft Exchange не определит, что Active Directory обновлен с данными отключенного почтового ящика. Чтобы ускорить процесс, запустите в базе данных командлет Update-StoreMailboxState.

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

Чтобы просмотреть отключенные почтовые ящики, запустите командлет Get-MailboxStatistics в базе данных и просмотрите результаты, поле DisconnectReason которых имеет значение Disabled. Дополнительные сведения см. в разделе Примеры 2 и 3 далее в этом разделе.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примечание. Чтобы восстановить содержимое основного почтового ящика в архивный почтовый ящик, используйте параметр TargetRootFolder, чтобы указать архивные папки почтовых ящиков для переноса содержимого. Это содержимое будет видно после восстановления. Если этот параметр не используется, восстановленный контент не отображается, так как оно сопоставлено с расположениями в архивном почтовом ящике, которые не видны пользователям.

Примеры

Пример 1

Get-MailboxStatistics -Database MBD01 | Where {$_.DisconnectReason -eq "SoftDeleted" -or $_.DisconnectReason -eq "Disabled"} | Format-List LegacyExchangeDN,DisplayName,MailboxGUID, DisconnectReason

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox 1d20855f-fd54-4681-98e6-e249f7326ddd -TargetMailbox Ayla

В локальной среде Exchange в этом примере используется командлет Get-MailboxStatistics для возврата DisplayName, LegacyExchangeDN и MailboxGUID (допустимые исходные значения удостоверений почтового ящика) для всех почтовых ящиков в базе данных почтовых ящиков с именем MBD01, у которых есть причина отключения SoftDeleted или Disabled.

Используя эти сведения, исходный почтовый ящик со значением MailboxGUID 1d20855f-fd54-4681-98e6-e249f7326ddd восстанавливается в целевой почтовый ящик со значением Alias Ayla.

Пример 2

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchive

В локальной среде Exchange этот пример восстанавливает содержимое исходного почтового ящика с параметром DisplayName Tony Smith в базе данных почтовых ящиков MBD01 в архивный почтовый ящик для Tony@contoso.com.

Параметры

-AcceptLargeDataLoss

Параметр AcceptLargeDataLoss указывает на то, что запрос должен выполняться, даже если невозможно скопировать большое количество элементов из исходного почтового ящика в целевой. С этим параметром не нужно указывать значение.

В Exchange 2013 или более поздней версии или в Exchange Online этот параметр необходимо использовать, если для параметра LargeItemLimit установлено значение 51 или выше. В противном случае команда завершится с ошибкой.

В Exchange 2010 этот параметр необходимо использовать, если для параметра BadItemLimit установлено значение 51 или выше. В противном случае команда завершится с ошибкой.

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, Exchange Online

-AllowLegacyDNMismatch

Параметр AllowLegacyDNMismatch указывает на необходимость продолжения операции, если значения LegacyExchangeDN исходного и целевого физических почтовых ящиков не совпадают. Указывать значение для этого параметра необязательно.

По умолчанию командлет проверяет наличие LegacyExchangeDN исходного физического почтового ящика у целевого пользователя в форме LegacyExchangeDN или прокси-адреса X500, соответствующего LegacyExchangeDN. Эта проверка позволяет предотвратить случайное восстановление исходного почтового ящика в неправильном целевом почтовом ящике.

Примечание: Этот параметр устарел в облачной службе. Чтобы выполнить запрос на восстановление почтового ящика для почтовых ящиков с не соответствующим устаревшим значениемExchangeDN, необходимо получить значение LegacyExchangeDN для исходного почтового ящика и добавить его в целевой почтовый ящик в качестве адреса прокси-сервера X500. Подробные инструкции см . в статье Восстановление неактивного почтового ящика.

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, Exchange Online

-AssociatedMessagesCopyOption

Параметр AssociatedMessagesCopyOption указывает, копируются ли сопоставленные сообщения при обработке запроса. Сопоставленные сообщения — это особые сообщения, которые содержат скрытые данные о правилах, представлениях и формах. Допустимые значения:

• DoNotCopy: связанные сообщения не копируются.
• MapByMessageClass: найдите связанное сообщение, найдя атрибут MessageClass исходного сообщения. Если сопоставленные сообщения этого класса есть и в исходной, и в целевой папках, то сопоставленное сообщение в целевой папке будет перезаписано. Если в целевой папке нет сопоставленного сообщения, то в ней создается копия исходного сообщения.
• Копировать: копирование связанных сообщений из источника в целевой объект. Если сообщения одного типа есть и в исходной, и в целевой папках, то они дублируются. Это значение используется по умолчанию.

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

Type:	FAICopyOption
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

-BadItemLimit

Параметр BadItemLimit указывает максимальное количество плохих элементов, разрешенных до сбоя запроса. Плохой элемент - это поврежденный элемент в исходном почтовом ящике, который нельзя скопировать в целевой почтовый ящик. В лимит плохих предметов также включены недостающие предметы. Отсутствующие элементы — это элементы из исходного почтового ящика, которые не удается найти в целевом почтовом ящике, когда запрос готов к выполнению.

Допустимым значением для этого параметра является целое число или бесконечное значение. Значение по умолчанию равно 0. Это означает, что запрос выдаст ошибку при обнаружении любых неправильных элементов. Если вы в порядке, оставив после себя несколько плохих элементов, вы можете установить для этого параметра разумное значение (рекомендуется 10 или ниже), чтобы запрос мог продолжаться. Если обнаружено слишком много плохих элементов, рассмотрите возможность использования командлета New-MailboxRepairRequest, чтобы попытаться исправить поврежденные элементы в исходном почтовом ящике, и повторите запрос.

В Exchange 2010, если вы установите это значение 51 или выше, вам также необходимо использовать переключатель AcceptLargeDataLoss. В противном случае команда завершится с ошибкой.

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

Type:	Unlimited
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

-BatchName

Параметр BatchName определяет описательное имя для восстановления пакета почтовых ящиков. Это имя можно использовать в параметре BatchName в качестве поиска строки во время использования командлета Get-MailboxRestoreRequest.

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, Exchange Online

-CompletedRequestAgeLimit

Параметр CompletedRequestAgeLimit указывает, как долго состояние выполненного запроса будет иметь значение Completed. Если этот параметр имеет значение 0, значение состояния немедленно очищается без изменения на Completed.

Type:	Unlimited
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

-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

-ConflictResolutionOption

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

• ForceCopy
• KeepAll
• KeepLatestItem
• KeepLatestItem
• KeepTargetItem
• UpdateFromSource

Type:	ConflictResolutionOption
Position:	Named
Default value:	KeepSourceItem
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

-ContentFilter

Этот параметр доступен только в облачной службе.

Параметр ContentFilter использует синтаксис фильтра OPATH для фильтрации результатов по указанным свойствам и значениям. Будет восстановлено только содержимое, соответствующее параметру ContentFilter. Для критериев поиска используется следующий синтаксис: "Property -ComparisonOperator 'Value'".

• Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
• Property — это свойство с поддержкой фильтрации. Сведения о фильтруемых свойствах см . в разделе Фильтруемые свойства для параметра ContentFilter.
• ComparisonOperator — это оператор сравнения OPATH (например -eq , для равных и -like для сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators.
• Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки ('Value' или '$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' используйте '$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте 500, $true, $false, или $null вместо них).

Можно связать несколько условий поиска вместе с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".

Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ContentFilterLanguage

Этот параметр доступен только в облачной службе.

Параметр ContentFilterLanguage указывает язык, используемый в параметре ContentFilter для поиска строк.

Допустимые входные данные для этого параметра — это поддерживаемое значение кода языка и региональных параметров из класса Microsoft платформа .NET Framework CultureInfo. Например, da-DK для датского языка или ja-JP для японского. Дополнительные сведения см. в разделе Класс CultureInfo.

Type:	CultureInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-CrossTenantRestore

Этот параметр доступен только в облачной службе.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-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, Exchange Online

-ExcludeDumpster

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

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

• Удаление
• Версии
• Очистка

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, Exchange Online

-ExcludeFolders

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

Если у вас развернуты службы федерации exADNoMk для единого входа в нелокальный почтовый ящик и они настроены так, чтобы использовать атрибут, отличный от ExchangeGUID, для запросов маркера входа, вам потребуется задать параметр ImmutableId. Чтобы обеспечить нормальную работу сценария межорганизационного развертывания exExchangeNoVersion, и exExchangeNoVersion, и AD FS должны запрашивать один и тот же маркер для одного и того же пользователя.

<FolderName>/*: используйте этот синтаксис для обозначения личной папки в папке, указанной в параметре SourceRootFolder, например MyProjects или MyProjects/FY2010.

#<FolderName>#/*: используйте этот синтаксис для обозначения хорошо известной папки независимо от имени папки на другом языке. Например, #Inbox# обозначает папку "Входящие" даже в турецкой локализации, где она называется "Gelen Kutusu". Известными папками являются следующие:

• Inbox;
• SentItems
• DeletedItems
• Календарь
• Контакты
• Черновики
• Журнал
• Задачи
• Примечания
• Нежелательная почта
• CommunicatorHistory
• Голосовая почта
• Fax
• Conflicts
• SyncIssues
• LocalFailures
• ServerFailures

Если пользователь создает личную папку с тем же именем, что и хорошо известная папка, и окружающим ее символом #, можно использовать обратную косую черту (\) в качестве escape-символа, чтобы указать эту папку. Например, если пользователь создает папку с именем #Notes# и вы хотите указать эту папку вместо известной папки Notes, используйте следующий синтаксис: \#Notes\#.

Если пользователь создает личную папку с именем, совпадающим с именем известной папки, заключая его в символы #, то для указания этой папки можно использовать обратную косую черту (\). Например, если пользователь создает папку #Notes# и требуется указать именно ее, а не известную папку Notes, используйте следующий синтаксис: \#Notes\#.

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, Exchange Online

-IncludeFolders

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

Если у вас развернуты службы федерации exADNoMk для единого входа в нелокальный почтовый ящик и они настроены так, чтобы использовать атрибут, отличный от ExchangeGUID, для запросов маркера входа, вам потребуется задать параметр ImmutableId. Чтобы обеспечить нормальную работу сценария межорганизационного развертывания exExchangeNoVersion, и exExchangeNoVersion, и AD FS должны запрашивать один и тот же маркер для одного и того же пользователя.

<FolderName>/*: используйте этот синтаксис для обозначения личной папки в папке, указанной в параметре SourceRootFolder, например MyProjects или MyProjects/FY2010.

#<FolderName>#/*: используйте этот синтаксис для обозначения хорошо известной папки независимо от имени папки на другом языке. Например, #Inbox# обозначает папку "Входящие" даже в турецкой локализации, где она называется "Gelen Kutusu". Известными папками являются следующие:

• Inbox;
• SentItems
• DeletedItems
• Календарь
• Контакты
• Черновики
• Журнал
• Задачи
• Примечания
• Нежелательная почта
• CommunicationHistory
• Голосовая почта
• Fax
• Conflicts
• SyncIssues
• LocalFailures
• ServerFailures

Если пользователь создает личную папку с тем же именем, что и хорошо известная папка, и окружающим ее символом #, можно использовать обратную косую черту (\) в качестве escape-символа, чтобы указать эту папку. Например, если пользователь создает папку с именем #Notes# и вы хотите указать эту папку вместо известной папки Notes, используйте следующий синтаксис: \#Notes\#.

Если пользователь создает личную папку с именем, совпадающим с именем известной папки, заключая его в символы #, то для указания этой папки можно использовать обратную косую черту (\). Например, если пользователь создает папку #Notes# и требуется указать именно ее, а не известную папку Notes, используйте следующий синтаксис: \#Notes\#.

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, Exchange Online

-InternalFlags

Этот параметр доступен только в локальной среде Exchange.

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

Type:	InternalMrsFlag[]
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

-LargeItemLimit

Параметр LargeItemLimit указывает максимальное количество больших элементов, разрешенных до сбоя запроса. Большой элемент - это сообщение в исходном почтовом ящике, размер которого превышает максимально допустимый размер сообщения в целевом почтовом ящике. Если целевой почтовый ящик не имеет специально настроенного значения максимального размера сообщения, используется значение для всей организации.

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

• Exchange 2016: ограничения на размер сообщений в Exchange Server
• Exchange Online: Ограничения Exchange Online

Допустимым значением для этого параметра является целое число или бесконечное значение. Значение по умолчанию равно 0. Это означает, что запрос выдаст ошибку при обнаружении любых крупных элементов. Если наличие нескольких крупных элементов допускается, этому параметру можно задать значение в разумных пределах (рекомендуем 10 или меньше), чтобы продолжить выполнение запроса.

Если вы установите это значение 51 или выше, вам также необходимо использовать переключатель AcceptLargeDataLoss. В противном случае команда завершится с ошибкой.

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

Type:	Unlimited
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

-MRSServer

Этот параметр доступен только в Exchange Server 2010.

Параметр MRSServer указывает полное доменное имя сервера клиентского доступа, на котором работает экземпляр службы репликации почтовых ящиков Microsoft Exchange (MRS). Этот параметр используется только для отладки. Используйте этот параметр только по просьбе сотрудников службы технической поддержки.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

Параметр Name определяет имя конкретного запроса, который необходимо отследить и отобразить. Так как для каждого почтового ящика может быть несколько запросов на восстановление, Exchange предшествует имени с псевдонимом почтового ящика. Например, если создается запрос на экспорт почтового ящика пользователя с псевдонимом "Kweku", а для этого параметра указывается значение "RestoreFailedMoves", то полный идентификатор этого запроса на экспорт будет иметь вид "Kweku\RestoreFailedMoves".

Если вы не указали имя для запроса на восстановление при его создании, Exchange автоматически создаст имя по умолчанию MailboxRestore. Exchange создает до 10 имен, начиная с MailboxRestore, а затем MailboxRestoreX (где X = 1–9).

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, Exchange Online

-Priority

Этот параметр доступен только в локальной среде Exchange.

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

• Самый низкий
• Lower
• Низкий
• Обычный (это значение по умолчанию.)
• Высокая
• Higher
• Highest
• Emergency

Type:	RequestPriority
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

-RemoteCredential

Этот параметр доступен только в облачной службе.

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteDatabaseGuid

Этот параметр доступен только в облачной службе.

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

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteHostName

Этот параметр доступен только в облачной службе.

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteRestoreType

Этот параметр доступен только в облачной службе.

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

Type:	RemoteRestoreType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RequestExpiryInterval

Этот параметр доступен только в локальной среде Exchange.

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

• Завершенный запрос автоматически удаляется на основании значения параметра CompletedRequestAgeLimit.
• В случае сбоя запроса необходимо вручную удалить его с помощью соответствующего командлета Remove-*Request.

Чтобы указать значение, введите его как период времени: dd.hh:mm:ss (dd — дни, hh — часы, mm — минуты и ss — секунды).

Когда вы используете значение Unlimited, завершенный запрос не удаляется автоматически.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-SkipMerging

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

• Папки ACL
• FolderProperties
• FolderRules
• InitialConnectionValidation

Этот параметр нужно использовать, только если запрос на восстановление не удается выполнить из-за правил папки, списков управления доступом к папке (ACL) или начальной проверки подключения.

Type:	SkippableMergeComponent[]
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

-SourceDatabase

Этот параметр доступен только в локальной среде Exchange.

Параметр SourceDatabase указывает идентификатор базы данных, из которой вы восстанавливаете обратимо удаленный или отключенный почтовый ящик. Вы можете использовать любое значение, уникальным образом идентифицирующее базу данных. Пример:

• имя;
• различающееся имя (DN);
• GUID

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

-SourceEndpoint

Этот параметр доступен только в облачной службе.

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

Type:	MigrationEndpointIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SourceExchangeGuid

Этот параметр доступен только в облачной службе.

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

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SourceIsArchive

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

Этот параметр можно использовать только с параметром SourceMailbox.

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

-SourceMailbox

Параметр SourceMailbox указывает на обратимо удаленный почтовый ящик, который вы хотите восстановить. Лучший способ идентифицировать обратимо удаленный почтовый ящик — это значение GUID. Значение GUID вы можете найти при помощи следующей команды: Get-Mailbox -SoftDeletedMailbox.

Type:	SourceMailbox
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceRootFolder

Параметр SourceRootFolder определяет корневую папку почтового ящика, данные которого восстанавливаются. Если этот параметр не задан, команда восстанавливает все папки.

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, Exchange Online

-SourceStoreMailbox

Этот параметр работает только в локальной среде Exchange.

Параметр SourceStoreMailbox указывает идентификатор MailboxGUID исходного почтового ящика, из которого требуется восстановить содержимое.

Вы можете найти MailboxGUID, выполнив командлет Get-MailboxStatistics.

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, Exchange Online

-SourceTenant

Этот параметр доступен только в облачной службе.

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

Type:	SmtpDomain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Suspend

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

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

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, Exchange Online

-SuspendComment

Параметр SuspendComment указывает описание того, почему запрос был приостановлен. Этот параметр можно использовать только в том случае, если указан параметр Suspend.

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, Exchange Online

-TargetIsArchive

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

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, Exchange Online

-TargetMailbox

Параметр TargetMailbox указывает GUID целевого почтового ящика или пользователя почты, в который требуется восстановить содержимое. Для успешного выполнения команды целевой почтовый ящик или пользователь почты должен существовать заранее.

Чтобы найти значение GUID для пользователя почтового ящика или почты, выполните командлеты Get-Mailbox или Get-MailUser.

В Exchange 2016 или более поздней версии и Exchange Online этот параметр является типом MailboxLocationIdParameter.

В Exchange 2013 или более ранней версии этот параметр является типом MailboxOrMailUserIdParameter.

Type:	MailboxLocationIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetRootFolder

Параметр TargetRootFolder указывает папку верхнего уровня, данные которой необходимо восстановить. Если этот параметр не указан, команда восстанавливает папки до самого верха структуры папок в целевом почтовом ящике или архиве. Содержимое существующих папок объединяется, а новые папки добавляются к целевой структуре папок.

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

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, Exchange Online

-TargetType

Параметр TargetType указывает тип почтового ящика, который является целевым для операции восстановления. Допустимые значения:

• Архив
• MailboxLocation
• Primary (это значение по умолчанию)

Type:	TargetTypeComponent
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

-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

-WorkloadType

Этот параметр доступен только в локальной среде Exchange.

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

Type:	RequestWorkloadType
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

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

Input types

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

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

Output types

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