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


Синтаксис LoadState

Команда LoadState.exe используется со средством миграции пользовательской среды (USMT) для восстановления хранилища, ранее записанного командой, ScanState.exe на целевой компьютер. В этой статье рассматривается LoadState.exe синтаксис команды и доступные с ним параметры.

Перед началом

Перед выполнением LoadState.exe команды обратите внимание на следующие элементы:

  • Чтобы обеспечить перенос всех параметров операционной системы, корпорация Майкрософт рекомендует выполнять LoadState.exe команды в режиме администратора из учетной записи с учетными данными администратора.

  • Сведения о требованиях к программному обеспечению для выполнения команды см. в LoadState.exe разделе Требования USMT.

  • Выйдите из нее LoadState.exe после выполнения команды. Некоторые параметры, например шрифты, обои и параметры скринсейвера, не вступают в силу до следующего входа пользователя.

  • Если не указано иное, каждый параметр можно использовать только один раз при запуске средства из командной строки.

  • LoadState не требует доступа контроллера домена для применения профилей домена. Эта функция доступна без дополнительной настройки. Для исходного компьютера не требуется доступ к контроллеру домена, когда профиль пользователя был собран с помощью ScanState. Однако профили домена недоступны, пока конечный компьютер не будет присоединен к домену.

  • В таблице Несовместимые параметры командной строки перечислены параметры, которые можно использовать вместе, а какие параметры командной строки несовместимы.

Синтаксис

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

Синтаксис LoadState.exe команды:

LoadState.exe StorePath [/i:[Path\]FileName] [/v:VerbosityLevel] [/nocompress] [/decrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName ] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsToWait] [/c] [/all] [/ui:[Имя_|домена_имя_компьютера\]Имя_пользователя] [/ue:[Имя_домена Имя_|компьютера].\]Имя_пользователя] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|справка]

Например, чтобы расшифровать хранилище и перенести файлы и параметры на компьютер, введите следующую команду:

LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:13 /decrypt /key:"mykey"

Варианты хранения

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

Параметр Command-Line Описание
StorePath Указывает папку, в которой хранятся файлы и данные параметров. При использовании LoadState.exe команды Необходимо указать StorePath. Невозможно указать несколько StorePath .
/decrypt /key:KeyString
или
/decrypt /key:"Key String"
или
/decrypt /keyfile:[путь]Имя_файла
Расшифровывает хранилище с указанным ключом. При использовании этого параметра ключ шифрования необходимо указать одним из следующих способов:
  • /key:KeyString указывает ключ шифрования. Если в KeyString есть пробел, аргумент должен быть заключен в кавычки (").
  • /keyfile:FilePathAndName указывает текстовый файл (.txt), содержащий ключ шифрования.

Значение KeyString не может превышать 256 символов.
Параметры /key и /keyfile нельзя использовать в одной командной строке.
Параметры /decrypt и /nocompress нельзя использовать в одной командной строке.
Важно!
Будьте внимательны при использовании /key параметров или keyfile . Например, любой пользователь, имеющий доступ к сценариям, выполняющим LoadState.exe команду с этими параметрами, также имеет доступ к ключу шифрования.

Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey
/decrypt:"сила шифрования" Параметр /decrypt принимает параметр командной строки для определения надежности шифрования, указанной для шифрования хранилища миграции. Дополнительные сведения о поддерживаемых алгоритмах шифрования см. в разделе Шифрование хранилища миграции.
/hardlink Позволяет восстанавливать данные пользовательского состояния из хранилища миграции с жесткой компоновкой. Параметр /nocompress должен быть указан с параметром /hardlink .
/nocompress Указывает, что хранилище не сжимается. Этот параметр следует использовать только в средах тестирования. Корпорация Майкрософт рекомендует использовать сжатое хранилище во время фактической миграции. Этот параметр нельзя использовать с параметром /decrypt .
Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress

Параметры правил миграции

USMT предоставляет следующие параметры, чтобы указать, какие файлы следует перенести.

Параметр Command-Line Описание
/i:[путь]Имя_файла (включая)
Указывает файл.xml , содержащий правила, определяющие, какие данные следует перенести. Этот параметр можно указать несколько раз, чтобы включить все файлы.xml (MigApp.xml, , MigSys.xmlMigDocs.xml и все созданные пользовательские .xml файлы). Путь может быть относительным или полным. Если переменная Path не указана, имя_файла должно находиться в текущем каталоге.

Дополнительные сведения о том, какие файлы следует указать, см. в разделе "XML-файлы" статьи Часто задаваемые вопросы .
/config:[путь]Имя_файла Указывает Config.xml файл, который LoadState.exe должна использовать команда. Этот параметр нельзя указать более одного раза в командной строке. Путь может быть относительным или полным. Если переменная Path не указана, имя _файла должно находиться в текущем каталоге.

В этом примере переносятся файлы и параметры на основе правил в файлах Config.xml, MigDocs.xmlи MigApp.xml :

LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:LoadState.log
/auto:"путь к файлам скриптов" Этот параметр позволяет указать расположение файлов по умолчанию .xml . Если путь не указан, USMT использует каталог, в котором находятся двоичные файлы USMT. Этот /auto параметр имеет тот же эффект, что и при использовании следующих параметров: /i:MigDocs.xml/i:MigApp.xml /v:5.

Параметры мониторинга

USMT предоставляет несколько параметров командной строки, которые можно использовать для анализа проблем, возникающих во время миграции.

Параметр Command-Line Описание
/l:[путь]Имя_файла Указывает расположение и имя журнала LoadState . Файлы журнала не могут храниться в StorePath. Путь может быть относительным или полным. Если переменная Path не указана, журнал создается в текущем каталоге. Параметр /v можно указать для настройки детализации журнала.

При выполнении LoadState.exe команды из общего сетевого ресурса l необходимо указать параметр, иначе USMT завершается ошибкой:

USMT не удалось создать файлы журналов

Чтобы устранить эту проблему, обязательно укажите /l параметр при запуске LoadState.exe из общего сетевого ресурса.
/v:<VerbosityLevel> (Детализация)

Включает подробные выходные данные в файле журнала LoadState . Значение по умолчанию — 0.
Для verbosityLevel можно задать один из следующих уровней:
  • 0 — включены только ошибки и предупреждения по умолчанию.
  • 1 — включает подробные выходные данные.
  • 4 . Включает вывод ошибок и состояния.
  • 5 . Включает подробные выходные данные и выходные данные состояния.
  • 8 . Включает вывод ошибок в отладчик.
  • 9 . Включает подробные выходные данные в отладчик.
  • 12 . Включает вывод ошибок и состояния в отладчик.
  • 13 . Включает подробные, состояние и выходные данные отладчика.

Пример:
LoadState.exe \server\share\migration\mystore /v:5 /i:MigDocs.xml /i:MigApp.xml
/progress:[Path]Имя_файла Создает необязательный журнал выполнения. Файлы журнала не могут храниться в StorePath. Путь может быть относительным или полным. Если переменная Path не указана, fileName создается в текущем каталоге.

Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:loadlog.log
/c Если указан этот параметр, LoadState.exe команда продолжает выполняться, даже если возникают неустранимые ошибки. Все файлы или параметры, вызывающие ошибку, регистрируются в журнале выполнения. Например, если на компьютере есть большой файл, который не помещается, LoadState.exe команда регистрирует ошибку и продолжает миграцию. Без параметра /cLoadState.exe команда завершает работу при первой ошибке. Раздел <ErrorControl> можно использовать в Config.xml файле, чтобы указать, какие ошибки чтения и записи файла или реестра можно безопасно игнорировать, а какие могут привести к сбою миграции. Это управление ошибками позволяет параметру командной /c строки безопасно пропускать все ошибки ввода-вывода в среде. Кроме того, /genconfig теперь параметр создает пример < раздела ErrorControl>, который включается путем указания сообщений об ошибках и требуемого Config.xml поведения в файле.
/r:<TimesToRetry> (Повторите попытку)

Указывает количество повторных попыток при возникновении ошибки при переносе пользовательского состояния с сервера. Значение по умолчанию — три раза. Этот параметр полезен в средах, где сетевое подключение не является надежным.

При восстановлении пользовательского состояния параметр не восстанавливает данные, /r которые были потеряны из-за сбоя оборудования сети, например неисправного или отключенного сетевого кабеля, или при сбое подключения к виртуальной частной сети (VPN). Вариант повтора предназначен для больших, загруженных сетей, где подключение является удовлетворительным, но задержка связи является проблемой.
/w:<SecondsBeforeRetry> (Подождите)

Указывает время ожидания (в секундах) перед повтором операции с сетевым файлом. Значение по умолчанию — 1 секунда.
/? или /help Отображает справку в командной строке.

Параметры пользователя

По умолчанию переносятся все пользователи. Единственный способ указать, какие пользователи следует включать и исключать, — использовать следующие параметры. Пользователи не могут быть исключены из .xml файлов миграции или с помощью Config.xml файла. Дополнительные сведения см. в разделе Определение пользователей.

Параметр Command-Line Описание
/все Переносит всех пользователей на компьютере.

USMT переносит все учетные записи пользователей на компьютере, если только учетная запись специально не исключена с параметрами /ue или /uel . По этой причине этот параметр не требуется указывать в командной строке. Однако при использовании /all параметра /uiтакже нельзя использовать параметры , /ue или /uel .
/ui:Имя_домена Имя_пользователя
или
/ui:"DomainName User Name"
или
/ui:ComputerName LocalUserName
(Включение пользователя)

Переносит указанного пользователя. По умолчанию все пользователи включаются в миграцию. Поэтому этот параметр полезен только при использовании с параметром /ue . Можно указать несколько /ui параметров, но /ui параметр нельзя использовать с параметром /all . DomainName и UserName могут содержать подстановочные знаки звездочки (*). Если указано имя пользователя, содержащее пробелы, оно должно быть заключено в кавычки (").

Например, чтобы включить только User2 из корпоративного домена, введите:

/ue:* /ui:corporate\user2

Примечание
Если пользователь указан для включения с параметром /ui и также указан для исключения с помощью /ue параметров или /uel , он включается в миграцию.

Дополнительные примеры см. в описании /uelпараметров , /ueи /ui в этой таблице.
/uel:<NumberOfDays>
или
/uel:<YYYY/MM/DD>
или
/uel:0
(Пользователь исключается на основе последнего входа)

Переносит только пользователей, которые вошли на исходный компьютер в течение указанного периода времени на основе даты последнего измененияфайла Ntuser.dat на исходном компьютере. Параметр /uel выступает в качестве правила включения. Например, параметр /uel:30 переносит пользователей, выполнивших вход или измененную учетную запись пользователя, в течение последних 30 дней с даты ScanState.exe выполнения команды. Можно указать количество дней или дату. Этот параметр нельзя использовать с параметром /all . USMT извлекает сведения о последнем входе с локального компьютера, поэтому при запуске этого параметра компьютер не нужно подключать к сети. Кроме того, если пользователь домена входит на другой компьютер, USMT не учитывает этот экземпляр входа.
Примечание
Параметр /uel недопустим при автономной миграции.

Примеры:
  • /uel:0 переносит учетные записи, которые были вошли в систему, на исходный компьютер при выполнении ScanState.exe команды.
  • /uel:90 переносит пользователей, которые вошли в систему или чьи учетные записи были изменены иным образом в течение последних 90 дней.
  • /uel:1 переносит пользователей, учетные записи которых были изменены за последние 24 часа.
  • /uel:2020/2/15 переносит пользователей, которые вошли в систему или чьи учетные записи были изменены с 15 февраля 2020 г.

Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /uel:0
/ue:DomainName\UserName
или
/ue"Имя_домена\Имя пользователя"
или
/ue:ComputerName\LocalUserName
(Исключение пользователя)

Исключает указанных пользователей из миграции. Можно использовать несколько /ue параметров, /ue но параметр нельзя использовать с параметром /all . DomainName и UserName могут содержать подстановочные знаки звездочки (*). Если указано имя пользователя, содержащее пробелы, оно должно быть заключено в кавычки (").

Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1
Дополнительные примеры см. в описании /uelпараметров , /ueи /ui в этой таблице.
/md:OldDomain:NewDomain
или
/md:LocalComputerName:NewDomain
(Перемещение домена)

Указывает новый домен для пользователя. Используйте этот параметр, чтобы изменить домен для пользователей на компьютере или перенести локального пользователя в учетную запись домена. OldDomain может содержать подстановочный знак звездочки ().

Этот параметр можно указать несколько раз. При консолидации пользователей в нескольких доменах в одном домене может потребоваться указать несколько /md параметров. Например, чтобы объединить пользователей из доменов Corporate и FarNorth в домен Fabrikam, укажите следующие параметры: /md:corporate:fabrikam и /md:farnorth:fabrikam.

При наличии конфликтов между двумя /md командами применяется первое указанное правило. Например, если /md:corporate:fabrikam указаны команды и /md:corporate:farnorth , корпоративные пользователи будут сопоставлены с доменом Fabrikam.
Примечание
Если указан домен, который не существовал на исходном компьютере, команда будет выполнена LoadState.exe успешно, без ошибок или предупреждений. Однако в этом случае пользователи не перемещаются в NewDomain , а остаются в исходном домене. Например, если contoso написана с ошибкой и вместо этого указан параметр /md:contso:fabrikam , пользователи остаются в contoso на конечном компьютере.

Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore
/progress:Progress.log /l:LoadState.log /md:contoso:fabrikam
/mu:OldDomain OldUserName:[NewDomain]NewUserName
или
/mu:OldLocalUserName:NewDomain NewUserName
(Перемещение пользователя)

Указывает новое имя пользователя для указанного пользователя. Если хранилище содержит несколько пользователей, можно указать несколько /mu параметров. С этим параметром нельзя использовать подстановочные знаки.

Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore
/progress:Progress.log /l:LoadState.log /mu:contoso\user1:fabrikam\user1
/lac:[пароль] (Создание локальной учетной записи)

Если учетная запись пользователя:
  • Локальная (внедоменная) учетная запись
  • Учетная запись, которая не существует на конечном компьютере
этот параметр указывает на создание учетной записи на конечном компьютере. Однако учетная запись отключена. Чтобы включить учетную запись, /lae также необходимо использовать параметр .

/lac Если параметр не указан, все локальные учетные записи пользователей, которые еще не существуют на конечном компьютере, не переносятся.

Пароль — это пароль для созданной учетной записи. По умолчанию используется пустой пароль.
Предостережение
Используйте переменную Password с осторожностью. Переменная Password предоставляется в виде обычного текста, и любой пользователь с доступом к компьютеру LoadState.exe , на котором выполняется команда, может получить пароль.
Кроме того, если на компьютере несколько пользователей, все перенесенные пользователи имеют один и тот же пароль.

Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore

Инструкции см. в разделе Миграция учетных записей пользователей.
/lae (Включение локальной учетной записи)

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

Пример:
LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore
/progress:Progress.log /l:LoadState.log /lac:password /lae

Инструкции см. в разделе Миграция учетных записей пользователей.

Примеры параметров /ui и /ue

Следующие примеры применяются к параметрам /ui и /ue . Параметр /ue можно заменить параметром /ui , чтобы включить, а не исключить указанных пользователей.

Поведение Команда
Исключите пользователя с именем User One в корпоративном домене. /ue:"corporate\user one"
Исключите пользователя с именем User1 в корпоративном домене. /ue:corporate\user1
Исключите локального пользователя с именем User1. /ue:%computername%\user1
Исключите всех пользователей домена. /ue:Domain
Исключите всех локальных пользователей. /ue:%computername%
Исключите пользователей во всех доменах с именами User1, User2 и т. д. /ue:\user

Совместное использование параметров

Параметры /uelи /ue/ui можно использовать вместе для миграции только пользователей, которые необходимо перенести.

Параметр /ui имеет приоритет над параметрами /ue и /uel. Если пользователь включается с помощью /ui параметра и также исключается с помощью /ue параметров или /uel , он включается в миграцию. Например, если /ui:contoso\* /ue:contoso\user1 задано значение , пользователь User1 переносится, так как /ui параметр имеет приоритет над параметром /ue .

Параметр /uel имеет приоритет над параметром /ue. Если пользователь вошел в систему в течение указанного периода времени, заданного /uel параметром , профиль этого пользователя переносится, даже если он исключен с помощью /ue параметра . Например, если /ue:contoso\user1 /uel:14 задан параметр , пользователь User1 переносится, если пользователь выполнил вход на компьютер в течение последних 14 дней.

Поведение Команда
Включите только User2 из домена Fabrikam и исключите всех остальных пользователей. /ue:* /ui:fabrikam\user2
Включите только локального пользователя с именем User1 и исключите всех остальных пользователей. /ue:* /ui:user1
Включите только пользователей домена из Contoso, за исключением Contoso\User1. Это поведение не может быть выполнено с помощью одной команды. Вместо этого, чтобы перенести этот набор пользователей, укажите следующие параметры:
  • С помощью средства командной строки ScanState введите:
    /ue:* /ui:contoso
  • С помощью программы командной строки LoadState введите:
    /ue:contoso\user1
Включать только локальных (не доменных) пользователей. /ue: /ui:%computername%*

Несовместимые параметры командной строки

В следующей таблице показано, какие параметры командной строки несовместимы с командой LoadState.exe . Если запись таблицы для определенной комбинации имеет ✅значение , параметры совместимы, и их можно использовать вместе. Символ ❌ означает, что параметры несовместимы. Например, параметр /nocompress нельзя использовать с параметром /encrypt .

Параметр Command-Line /keyfile /nocompress /genconfig /все
/v
/nocompress Н/Д
/ключ
/расшифровать Обязательно*
/keyfile Н/Д
/l
/прогресс
/r
/w
/c
/p Н/Д
/все
/Пользовательского интерфейса
/ue
/uel
/genconfig Н/Д
/config
StorePath
/md
/мю
/Лаэ
/природный лак

Примечание.

/key Параметр или /keyfile должен быть указан с параметром /decrypt .