New-PublicFolderMigrationRequest

Синтаксис

Default (По умолчанию)

New-PublicFolderMigrationRequest
    [[-Name] <String>]
    -SourceDatabase <DatabaseIdParameter>
    [-AcceptLargeDataLoss]
    [-BadItemLimit <Unlimited>]
    [-BatchName <String>]
    [-CompletedRequestAgeLimit <Unlimited>]
    [-Confirm]
    [-CSVData <Byte[]>]
    [-CSVStream <Stream>]
    [-DomainController <Fqdn>]
    [-InternalFlags <InternalMrsFlag[]>]
    [-LargeItemLimit <Unlimited>]
    [-MigrationMailbox <MailboxIdParameter>]
    [-Priority <RequestPriority>]
    [-RequestExpiryInterval <Unlimited>]
    [-SkipMerging <SkippableMergeComponent[]>]
    [-SourceEndpoint <MigrationEndpointIdParameter>]
    [-Suspend]
    [-SuspendComment <String>]
    [-WhatIf]
    [-WorkloadType <RequestWorkloadType>]
    [<CommonParameters>]

Описание

Примеры

Пример 1

New-PublicFolderMigrationRequest -SourceDatabase PFDB01 -CSVData ([System.IO.File]::ReadAllBytes('C:\PFMigration\CSVData.csv'))

Параметры

-AcceptLargeDataLoss

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

Свойства параметров

Наборы параметров

-BadItemLimit

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

Свойства параметров

Наборы параметров

-BatchName

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр BatchName указывает описательное имя пакета миграции общедоступных папок. Параметр BatchName можно использовать в качестве строки для поиска при использовании командлета Get-PublicFolderMigrationRequest.

Свойства параметров

Наборы параметров

-CompletedRequestAgeLimit

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр CompletedRequestAgeLimit определяет, как долго хранится выполненный запрос до автоматического удаления. Значение параметра CompletedRequestAgeLimit по умолчанию составляет 30 дней.

Свойства параметров

Наборы параметров

-Confirm

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

• Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
• Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Подтвердить без значения приводит к приостановке, которая заставляет подтвердить команду перед продолжением.

Свойства параметров

Наборы параметров

-CSVData

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр CSVData указывает выходной файл сопоставления, созданный сценарием PublicFoldertoMailboxMapGenerator.ps1. Этот параметр используется для локальной миграции.

Допустимое значение для этого параметра требует считывания файла в байтовый объект с использованием следующего синтаксиса: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Эту команду можно использовать в качестве значения параметра или записать выходные данные в переменную ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) и использовать переменную в качестве значения параметра ($data).

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

Свойства параметров

Наборы параметров

-CSVStream

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр CSVStream указывает выходной файл сопоставления, созданный сценарием PublicFoldertoMailboxMapGenerator.ps1. Этот параметр используется для удаленной миграции.

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

Свойства параметров

Наборы параметров

-DomainController

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Свойства параметров

Наборы параметров

-InternalFlags

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Наборы параметров

-LargeItemLimit

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

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

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

Свойства параметров

Наборы параметров

-MigrationMailbox

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Наборы параметров

-Name

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Наборы параметров

-Priority

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

Свойства параметров

Наборы параметров

-RequestExpiryInterval

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

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

Свойства параметров

Наборы параметров

-SkipMerging

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Наборы параметров

-SourceDatabase

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

Свойства параметров

Наборы параметров

-SourceEndpoint

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Наборы параметров

-Suspend

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

Свойства параметров

Наборы параметров

-SuspendComment

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Наборы параметров

-WhatIf

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Наборы параметров

-WorkloadType

Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

Свойства параметров

Наборы параметров

CommonParameters

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

Input types

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

Output types