Синтаксис команды LoadState
В этом разделе рассматриваются синтаксис и параметры команды LoadState.
В этом разделе
Перед началом работы
Синтаксис
Параметры хранилища
Параметры правил миграции
Параметры наблюдения
Параметры пользователя
Несовместимые параметры командной строки
Перед началом работы
Перед выполнением команды LoadState обратите внимание на следующее.
Чтобы выполнить перенос всех параметров операционной системы, рекомендуется выполнять команды LoadState с правами администратора из учетной записи, которая обладает такими правами.
Дополнительные сведения о требованиях к программному обеспечению для выполнения команды LoadState см. в разделе Требования к средству USMT.
Необходимо выйти из системы после выполнения команды LoadState. Ряд параметров (например, параметры шрифтов, обоев и экранной заставки) вступят в силу только при следующем входе пользователя в систему.
Если не указано иное, при запуске средства из командной строки каждый из параметров можно использовать только один раз.
Средству LoadState не требуется доступ к контроллеру домена для применения профилей домена. Эти функции доступны без дополнительной настройки. Исходному компьютеру не требуется доступ к контроллеру домена, если профиль пользователя был сохранен с помощью средства ScanState. Тем не менее профили домена будут недоступны до тех пор, пока целевой компьютер не будет присоединен к этому домену.
В таблице Несовместимые параметры командной строки приводятся сведения о параметрах, которые можно и нельзя использовать совместно.
Синтаксис
В этом разделе рассматривается синтаксис и применение параметров командной строки, доступных при использовании команды LoadState. Параметры можно указывать в произвольном порядке. Если параметр содержит аргумент, то он отделяется либо двоеточием, либо пробелом.
Синтаксис команды LoadState:
loadstate 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:[DomainName|ComputerName\]UserName] [/ue:[[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|help]
Например, чтобы расшифровать хранилище и перенести файлы и параметры на компьютер под управлением Windows 7, введите в командной строке:
loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"
Параметры хранилища
Средство миграции пользовательской среды предоставляет следующие параметры, которые можно использовать, чтобы указать способ и место хранения переносимых данных.
| Параметр командной строки | Описание |
|---|---|
StorePath |
Определяет папку, в которой будут сохранены файлы и параметры. Необходимо указать StorePath при использовании команды LoadState. Нельзя указать несколько значений StorePath. |
/decrypt/key:KeyString или /decrypt/key:"Key String" или /decrypt/keyfile:[Path\]FileName |
Расшифровывает хранилище с помощью указанного ключа. При указании этого параметра необходимо задать ключ шифрования одним из следующих способов.
KeyString не может превышать 256 символов. Параметры /key и /keyfile нельзя использовать в одной командной строке. Параметры /decrypt и /nocompress нельзя использовать в одной командной строке. ВажноНеобходимо соблюдать осторожность при использовании этого параметра, поскольку у любого пользователя с доступом к скрипту командной строки LoadState будет также доступ к ключу шифрования. Пример.
|
/decrypt:"encryption strength" |
Параметр /decrypt принимает параметр командной строки, определяющий длину ключа шифрования хранилища миграции. Дополнительные сведения о поддерживаемых алгоритмах шифрования см. в разделе Шифрование хранилища миграции. |
/hardlink |
Позволяет восстановить данные о пользовательской среде из хранилища миграции с жесткой связью. Параметр /nocompress необходимо указывать с параметром /hardlink. |
/nocompress |
Определяет, что хранилище используется без сжатия. Этот параметр следует использовать только для сред тестирования. В реальном процессе переноса рекомендуется использовать сжатое хранилище. Этот параметр нельзя использовать с параметром /decrypt. Пример.
|
Параметры правил миграции
Средство миграции пользовательской среды предоставляет возможность использовать следующие параметры, чтобы указать, какие файлы необходимо перенести.
| Параметр командной строки | Описание |
|---|---|
/i:[Path\]FileName |
(include) Указывает XML-файл, содержащий правила, которые определяют, какое состояние следует перенести. Этот параметр можно указать несколько раз, чтобы включить в процесс переноса все XML-файлы (MigApp.xml, MigSys.xml, MigDocs.xml и все созданные пользовательские XML-файлы). Path может представлять собой относительный или полный путь. Если не указать переменную Path, то файл FileName должен быть расположен в текущем каталоге. Дополнительные сведения о том, какие файлы следует указывать, см. в разделе "XML-файлы" темы Вопросы и ответы. |
/config:[Path\]FileName |
Указывает файл Config.xml, который должна использовать команда LoadState. Этот параметр можно указать в командной строке только один раз. Path может представлять собой относительный или полный путь. Если не указать переменную Path, то файл FileName должен быть расположен в текущем каталоге. В следующем примере демонстрируется перенос файлов и параметров по правилам, указанным в файлах Config.xml, MigDocs.xml и MigApp.xml.
|
/auto:"path to script files" |
Параметр позволяет указать расположение XML-файлов по умолчанию и затем запустить процесс переноса. Если путь не указан, то USMT будет использовать каталог, в котором размещены двоичные файлы USMT. Параметр /auto аналогичен использованию следующих параметров: /i:MigDocs.xml, /i:MigApp.xml /v:5. |
Параметры наблюдения
Средство миграции пользовательской среды предоставляет ряд параметров командной строки, которые можно использовать для анализа проблем, которые могут возникнуть во время переноса.
| Параметр командной строки | Описание |
|---|---|
/l:[Path\]FileName |
Задает расположение и имя журнала для команды LoadState. Файлы журнала нельзя сохранять в каталоге StorePath. Path может представлять собой относительный или полный путь. Если не указать переменную Path, то журнал будет создан в текущем каталоге. Параметр /v позволяет изменить объем выводимых данных. При выполнении команды LoadState из общего сетевого ресурса необходимо указать этот параметр, иначе USMT завершит работу с ошибкой "USMT не удалось создать файл журнала". Для устранения ошибки используйте параметр /l:load.log. |
/v:<VerbosityLevel> |
(Verbosity) Активирует подробный вывод данных в файл журнала LoadState. Значение по умолчанию — 0. Можно присвоить параметру VerbosityLevel одно из следующих значений.
УровеньОбъяснение
0 Включены только стандартные ошибки и предупреждения.
1 Включает режим подробного протоколирования.
4 Включает режим протоколирования отчетов об ошибках и состояниях.
5 Включает режим подробного протоколирования состояния.
8 Включает перенос отчета об ошибке в отладчик.
9 Включает перенос подробного отчета об ошибке в отладчик.
12 Включает перенос отчета об ошибке и состоянии в отладчик.
13 Включает режим подробного отчета, отчета о состоянии и отчета отладчика.
Пример.
|
/progress:[Path\]FileName |
Создает необязательный журнал хода выполнения. Файлы журнала нельзя сохранять в каталоге StorePath. Path может представлять собой относительный или полный путь. Если не указано значение переменной Path, то в текущем каталоге создается FileName . Пример.
|
/c |
При указании этого параметра команда LoadState будет работать даже при возникновении ошибок, не являющихся неустранимыми. Файлы и параметры, вызвавшие ошибку, записываются в журнал хода выполнения. Например, при попытке переноса большого файла, не умещающегося на компьютере, команда LoadState запишет ошибку в журнал и продолжит перенос. Без параметра /c команда LoadState завершит работу при первой ошибке. Воспользуйтесь новым разделом <ErrorControl> в файле Config.xml, чтобы указать, какие ошибки чтения или записи файла или реестра можно пропустить, а какие должны привести к сбою миграции. Это позволяет использовать параметр командной строки /c для безопасного пропуска всех ошибок ввода-вывода в вашей среде. Кроме того, параметр /genconfig теперь создает образец раздела <ErrorControl>, который включается путем указания сообщений об ошибках и желаемого поведения в файле Config.xml. |
/r:<TimesToRetry> |
(Повтор) Определяет количество повторных попыток в случае ошибки при переносе пользовательской среды с сервера. По умолчанию выполняется три повтора. Этот параметр полезен в средах с ненадежным подключением к сети. При сохранении состояния пользователя параметр /r не удастся использовать для восстановления данных, утраченных вследствие сетевого сбоя, например неисправности или отключения сетевого кабеля, или при сбое подключения виртуальной частной сети. Параметр повтора предназначен для использования в крупных сетях с интенсивным трафиком, в которых качество соединения удовлетворительно, но наблюдаются проблемы из-за задержек передачи данных. |
/w:<SecondsBeforeRetry> |
(Ожидание) Определяет время (в секундах) между повторными попытками операций с файлами по сети. По умолчанию используется значение "1 секунда". |
/? или /help |
Вывод справки в окне командной строки. |
Параметры пользователя
По умолчанию осуществляется миграция всех пользователей. Единственный способ указать, каких пользователей включить, а каких исключить из миграции, — это указать следующие параметры. Нельзя исключить пользователей в XML-файлах переноса или при помощи файла Config.xml. Дополнительные сведения см. в разделе Идентификация пользователей.
| Параметр командной строки | Описание |
|---|---|
/all |
Переносит всех пользователей на данном компьютере. USMT переносит все учетные записи пользователей на компьютере, если не указано, что какая-либо учетная запись должна быть исключена с помощью параметров /ue или /uel. Поэтому данный параметр не обязательно указывать в командной строке. Однако, если вы решите использовать параметр /all, вы не сможете использовать параметры /ui, /ue или /uel. |
/ui:DomainName\UserName или /ui:"DomainName\User Name" или /ui:ComputerName\LocalUserName |
(Включение пользователя) Перенос указанного пользователя. По умолчанию в перенос включены все пользователи. Поэтому этот параметр полезен только при использовании с параметром /ue. Можно указать несколько параметров /ui, но нельзя использовать параметр /ui с параметром /all. DomainName и UserName могут содержать подстановочный знак звездочки (*). Если имя пользователя содержит пробелы, необходимо заключить его в кавычки. Пример.
Если пользователь указан для включения с помощью параметра /ui и также указан для исключения с помощью параметра /ue или /uel, пользователь будет включен в миграцию. Дополнительные примеры см. в описаниях параметров /uel, /ue и /ui в этой таблице. |
/uel:<NumberOfDays> или /uel:<YYYY/MM/DD> или /uel:0 |
(Исключение пользователей на основании последнего входа в систему) Переносит только пользователей, которые выполнили вход на исходный компьютер в течение указанного периода времени на основании даты, указанной в разделе Last Modified файла Ntuser.dat на исходном компьютере. Параметр /uel действует как правило включения. Например, параметр /uel:30 переносит пользователей, выполнивших вход, или пользователей, чья учетная запись была изменена в пределах 30 дней от даты запуска команды ScanState. Можно указать количество дней или дату. Вы не можете использовать этот параметр с параметром /all. USMT извлекает сведения о последнем времени входа из локального компьютера, чтобы компьютеру не требовалось подключение к сети при запуске этого параметра. Кроме того, если пользователь домена выполнил вход на другом компьютере, этот экземпляр входа не будет рассматриваться в USMT. ПримечаниеПараметр /uel не используется при миграции в автономном режиме. Примеры.
Пример.
|
/ue:DomainName\UserName или /ue:"DomainName\User Name" или /ue:ComputerName\LocalUserName |
(Исключение пользователя) Исключает указанных пользователей из переноса. Можно указать несколько параметров /ue, но нельзя использовать параметр /ue с параметром /all. DomainName и UserName могут содержать подстановочный знак звездочки (*). Если имя пользователя содержит пробелы, необходимо заключить его в кавычки. Пример.
Дополнительные примеры см. в описаниях параметров /uel, /ue и /ui в этой таблице. |
/md:OldDomain:NewDomain или /md:LocalComputerName:NewDomain |
(Перемещение домена) Определяет для данного пользователя новый домен. Используйте этот параметр в целях изменения домена для пользователей компьютера или переноса локальных пользователей на учетную запись домена. OldDomain может содержать подстановочный знак звездочки (*). Этот параметр можно указать более одного раза. Можно указать несколько параметров /md, если нужно собрать пользователей из нескольких доменов в один домен. Например, можно указать следующие действия, чтобы собрать пользователей из доменов Corporate и FarNorth в домен Fabrikam: В случае конфликта между двумя командами /md применяется первое из указанных правил. Например, если выполнить команды Если указать домен OldDomain, который не существует на исходном компьютере, команда LoadState выполнит работу без ошибок. Однако в этом случае пользователи не будут перемещены в домен NewDomain и останутся в исходном домене. Например, если вы допустите ошибку в слове "contoso" и введете "/md:contso:fabrikam", пользователи останутся в домене contoso на целевом компьютере. Пример.
|
/mu:OldDomain\OldUserName:[NewDomain\]NewUserName или /mu:OldLocalUserName:NewDomain\NewUserName |
Задает новое имя пользователя для указанного пользователя. Если в хранилище больше одного пользователя, можно указать несколько параметров /mu. С этим параметром нельзя использовать подстановочные знаки. Пример.
|
/lac:[Password] |
(Создание локальной учетной записи) Указывает, что, если учетная запись является локальной (не доменной) и не существует на целевом компьютере, средство миграции пользовательской среды создаст учетную запись на целевом компьютере, но она будет отключена. Чтобы включить эту учетную запись, необходимо дополнительно использовать параметр /lae. Если параметр /lac не определен, все локальные учетные записи пользователей, которых еще нет на целевом компьютере, не будут перенесены. Password — пароль для создаваемой учетной записи. По умолчанию используется пустой пароль. ВниманиеИспользуйте переменную Password с осторожностью, потому что она передается в виде обычного текста и может быть получена любым пользователем, имеющим доступ к компьютеру, на котором запущена команда LoadState. Кроме того, если на компьютере несколько пользователей, после переноса все пользователи будут иметь один и тот же пароль. Пример.
Инструкции см. в разделе Перенос учетных записей пользователей. |
/lae |
(Включение локальной учетной записи) Включает учетную запись, созданную с помощью параметра /lac. Параметр /lac необходимо использовать вместе с этим параметром. Пример.
Инструкции см. в разделе Перенос учетных записей пользователей. |
Примеры для параметров /ui и /ue
Следующие примеры применимы к параметрам /ui и /ue. Можно заменить параметр /ue на параметр /ui, чтобы включить, а не исключить указанных пользователей.
| Поведение | Команда |
|---|---|
Исключить пользователя с именем User One из домена Corporate. |
|
Исключить пользователя с именем User1 из домена Corporate. |
|
Исключить локального пользователя с именем User1. |
|
Исключить всех пользователей домена. |
|
Исключить всех локальных пользователей. |
|
Исключить пользователей всех доменов, имена которых User1, User2 и т. д. |
|
Совместное использование параметров
Параметры /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 и исключить всех остальных. |
|
Добавить только локального пользователя с именем User1 и исключить всех остальных. |
|
Добавить только пользователей домена Contoso, за исключением Contoso\User1. |
Такое поведение невозможно реализовать с помощью одной команды. Чтобы перенести этот набор пользователей, необходимо выполнить следующие действия.
|
Добавить только локальных пользователей (не пользователей домена). |
|
Несовместимые параметры командной строки
В следующей таблице указано, какие параметры командной строки несовместимы с командой LoadState. Если ячейка таблицы, соответствующая отдельному сочетанию параметров, пуста, данные параметры совместимы и могут использоваться совместно. Символ X означает, что параметры несовместимы. Например, параметр /nocompress нельзя использовать с параметром /encrypt.
| Параметр командной строки | /keyfile | /nocompress | /genconfig | /all |
|---|---|---|---|---|
/i |
||||
/v |
||||
/nocompress |
Н/Д |
X |
||
/key |
X |
X |
||
/decrypt |
Обязательный* |
X |
X |
|
/keyfile |
Н/Д |
X |
||
/l |
||||
/progress |
X |
|||
/r |
X |
|||
/w |
X |
|||
/c |
X |
|||
/p |
X |
Н/Д |
||
/all |
X |
|||
/ui |
X |
X |
||
/ue |
X |
X |
||
/uel |
X |
X |
||
/genconfig |
Н/Д |
|||
/config |
X |
|||
StorePath |
||||
/md: |
||||
/mu |
||||
/lae |
||||
/lac |
Примечание
Необходимо указать параметр /key или /keyfile с параметром /encrypt.