Синтаксис 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:[путь]Имя_файла |
Расшифровывает хранилище с указанным ключом. При использовании этого параметра ключ шифрования необходимо указать одним из следующих способов:
Значение 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 можно задать один из следующих уровней:
Пример: 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 недопустим при автономной миграции.Примеры:
Пример: 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. | Это поведение не может быть выполнено с помощью одной команды. Вместо этого, чтобы перенести этот набор пользователей, укажите следующие параметры:
|
| Включать только локальных (не доменных) пользователей. | /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 .