Синтаксис команды 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

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

  • /key:KeyString задает ключ шифрования. Если KeyString содержит пробел, необходимо заключить аргумент в кавычки.

  • /keyfile:FilePathAndName указывает на текстовый (TXT) файл, в котором содержится ключ шифрования.

KeyString не может превышать 256 символов.

Параметры /key и /keyfile нельзя использовать в одной командной строке.

Параметры /decrypt и /nocompress нельзя использовать в одной командной строке.

Важно  

Необходимо соблюдать осторожность при использовании этого параметра, поскольку у любого пользователя с доступом к скрипту командной строки LoadState будет также доступ к ключу шифрования.

 

Пример.

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /decrypt /key:mykey

/decrypt:"encryption strength"

Параметр /decrypt принимает параметр командной строки, определяющий длину ключа шифрования хранилища миграции. Дополнительные сведения о поддерживаемых алгоритмах шифрования см. в разделе Шифрование хранилища миграции.

/hardlink

Позволяет восстановить данные о пользовательской среде из хранилища миграции с жесткой связью. Параметр /nocompress необходимо указывать с параметром /hardlink.

/nocompress

Определяет, что хранилище используется без сжатия. Этот параметр следует использовать только для сред тестирования. В реальном процессе переноса рекомендуется использовать сжатое хранилище. Этот параметр нельзя использовать с параметром /decrypt.

Пример.

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /nocompress

 

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

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

Параметр командной строкиОписание

/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.

loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:5 /l:loadstate.log

/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Включает режим подробного отчета, отчета о состоянии и отчета отладчика.

 

Пример.

loadstate \\server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml

/progress:[Path\]FileName

Создает необязательный журнал хода выполнения. Файлы журнала нельзя сохранять в каталоге StorePath. Path может представлять собой относительный или полный путь. Если не указано значение переменной Path, то в текущем каталоге создается FileName .

Пример.

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log

/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 могут содержать подстановочный знак звездочки (*). Если имя пользователя содержит пробелы, необходимо заключить его в кавычки.

Пример.

  • Чтобы включить только пользователя User2 из домена Corporate, введите:

    /ue:*\* /ui:corporate\user2

Примечание  

Если пользователь указан для включения с помощью параметра /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 не используется при миграции в автономном режиме.

 

Примеры.

  • /uel:0 переносит учетные записи, которые были в системе на исходном компьютере, когда выполнялась команда ScanState.

  • /uel:90 переносит пользователей, которые выполнили вход или учетная запись которых была изменена другим образом за последние 90 дней.

  • /uel:1 переносит пользователей, учетные записи которых изменялись в течение последних 24 часов.

  • /uel:2002/1/15 переносит пользователей, которые входили в систему или имеют учетные записи, изменявшиеся после 15 января 2002 года.

Пример.

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0

/ue:DomainName\UserName

или

/ue:"DomainName\User Name"

или

/ue:ComputerName\LocalUserName

(Исключение пользователя)

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

Пример.

loadstate /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, пользователи домена Corporate будут сопоставлены с доменом Fabrikam.

Примечание  

Если указать домен OldDomain, который не существует на исходном компьютере, команда LoadState выполнит работу без ошибок. Однако в этом случае пользователи не будут перемещены в домен NewDomain и останутся в исходном домене. Например, если вы допустите ошибку в слове "contoso" и введете "/md:contso:fabrikam", пользователи останутся в домене contoso на целевом компьютере.

 

Пример.

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /md:contoso:fabrikam

/mu:OldDomain\OldUserName:[NewDomain\]NewUserName

или

/mu:OldLocalUserName:NewDomain\NewUserName

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

Пример.

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /mu:contoso\user1:fabrikam\user1

/lac:[Password]

(Создание локальной учетной записи)

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

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

Password — пароль для создаваемой учетной записи. По умолчанию используется пустой пароль.

Внимание  

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

Кроме того, если на компьютере несколько пользователей, после переноса все пользователи будут иметь один и тот же пароль.

 

Пример.

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

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

/lae

(Включение локальной учетной записи)

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

Пример.

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

/progress:prog.log /l:load.log /lac:password /lae

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

 

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

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

ПоведениеКоманда

Исключить пользователя с именем User One из домена Corporate.

/ue:"corporate\user one"

Исключить пользователя с именем User1 из домена Corporate.

/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. Если ячейка таблицы, соответствующая отдельному сочетанию параметров, пуста, данные параметры совместимы и могут использоваться совместно. Символ 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.

 

Связанные разделы

Библиотека XML-элементов

 

 

Показ: