Синтаксис команды ScanState:
scanstate [StorePath] [/i:[Path\]FileName] [/o] [/v:VerbosityLevel] [/nocompress] [/localonly] [/encrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsBeforeRetry] [/c] [/p] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|help]
Примеры команд:
Переносит только активные (использовались в последнии полгода) доменные профили на диск D:
scanstate d:\migr\ /o /c /i:miguser.xml /localonly /uel:180 /ue:%computername%\*
Переносит все учётные записи, которые использовались в ОС в сетевое хранилище:
scanstate \\test02\migr /o /c /i:miguser.xml /localonly
Чтобы создать файл Config.xml в текущем каталоге, используйте команду:
scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13
Чтобы создать зашифрованное хранилище с помощью файла Config.xml и XML-файлов миграции, принятых по умолчанию, используйте команду:
scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:13 /encrypt /key:"mykey"
Ключи:
| StorePath | Указывает папку для сохранения файлов и параметров. Обратите внимание, что StorePath не может быть c:\. Необходимо указать параметр StorePath в команде ScanState, за исключением случаев, когда используется параметр /genconfig. Нельзя указывать более одного местоположения StorePath. |
| /o | Необходим для перезаписи любых существующих данных в хранилище миграции или файле Config.xml. Если он не указан, команда ScanState не выполняется в случае, если в хранилище миграции уже имеются данные. Этот параметр нельзя использовать в командной строке более одного раза. |
| /vsc |
Этот параметр включает службу теневого копирования томов для переноса заблокированных или используемых файлов. Этот параметр командной строки исключает большинство ошибок, связанных с блокировкой файлов, которые обычно возникают в разделе <ErrorControl>. Этот параметр можно использовать только с исполняемым файлом ScanState и нельзя сочетать с параметром /hardlink. |
| /hardlink | /Разрешает создание в указанном расположении хранилища миграции с жесткими связями. Параметр /nocompress должен быть указан с параметром /hardlink. |
| /encrypt [{/key:<KeyString> | /keyfile:<file>]} |
Зашифровывает хранилище с помощью указанного ключа. По умолчанию шифрование отключено. При указании этого параметра необходимо задать ключ шифрования одним из следующих способов. /key:KeyString задает ключ шифрования. Если в KeyString имеется пробел, необходимо заключить KeyString в кавычки. /keyfile:FilePathAndName указывает на текстовый (TXT) файл, в котором содержится ключ шифрования. Рекомендуется, чтобы KeyString была длиной не менее 8 символов, но и не превышала 256 символов. Параметры /key и /keyfile нельзя использовать в одной командной строке. Параметры /encrypt и /nocompress нельзя использовать в одной командной строке. Важно scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /encrypt /key:mykey |
| /encrypt:<EncryptionStrength> | Параметр /encrypt принимает параметр командной строки, определяющий длину ключа шифрования хранилища миграции. |
| /nocompress | Отключает сжатие данных и сохраняет файлы в скрытую папку с именем "File" по адресу StorePath\USMT. По умолчанию сжатие включено. При комбинировании параметра /nocompress и параметра /hardlink создается хранилище миграции с жесткими связями. Вы можете использовать несжатое хранилище для просмотра данных, сохраненных при помощи USMT, поиска и устранения неисправностей или запуска антивирусной программы для проверки всех файлов. Этот параметр следует использовать только в тестовых средах, поскольку мы рекомендуем использовать сжатое хранилище в момент фактической миграции. Однако использование такого хранилища допустимо при сочетании параметров /nocompress и /hardlink.
Параметры /nocompress и /encrypt нельзя использовать вместе в одном операторе командной строки. Но если вы выберите миграцию с использованием несжатого хранилища при использовании команды LoadState, то будет выполнена миграция каждого файла в верно выбранное место целевого ПК без использования промежуточного временного хранилища. |
| /offline:"path to an offline.xml file" | Этот параметр используется для задания пути к автономному XML-файлу, в котором могут быть указаны другие параметры автономной миграции, например автономный каталог Windows или какое-либо перенаправление домена или папок, необходимое для миграции. |
| /offlinewindir:"path to a Windows directory" | Этот параметр задает автономный каталог Windows, из которого команда ScanState извлекает состояние пользователей. Автономный каталог может быть Windows.old при запуске команды ScanState в Windows или каталогом Windows при запуске команды ScanState в WinPE. |
| /offlinewinold:"Windows.old directory" | Этот параметр командной строки осуществляет переход в автономный режим миграции и начинает перенос данных из указанного расположения. Он предназначен для использования только в сценариях миграции Windows.old, когда выполняется перенос данных из каталога Windows.old. |
| /i:[Path\]FileName |
Создает необязательный файл Config.xml, но не создает хранилище миграции. Чтобы гарантировать, что в этом файле перечислены все доступные для переноса компоненты, приложения и параметры, следует создавать его на исходном компьютере, содержащем все компоненты, приложения и параметры, которые будут представлены на целевых компьютерах. Кроме того, необходимо указать другие XML-файлы для миграции, используя параметр /i, если указан этот параметр. После создания этого файла необходимо использовать с командой ScanState с параметром /config. Единственные параметры, которые вы можете указать с этим параметром, — /i, /v и /l. Нельзя задавать StorePath, поскольку параметр /genconfig не создает хранилище. Path может представлять собой относительный или полный путь. Если не указано значение переменной Path, то в текущем каталоге создается FileName . |
| /config:[Path\]FileName |
Указывает файл Config.xml, который должен использоваться командой ScanState для создания хранилища. Этот параметр нельзя использовать в командной строке более одного раза. Path может представлять собой относительный или полный путь. Если не указать переменную Path, то файл FileName должен быть расположен в текущем каталоге. Следующий пример иллюстрирует создание хранилища с помощью файлов Config.xml, MigDocs.xml и MigApp.xml. scanstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:13 /l:scan.log В следующем примере выполняется перенос файлов и параметров на целевой компьютер при помощи файлов Config.xml, MigDocs.xml и MigApp.xml: loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:13 /l:load.log |
| /auto:path to script files | Этот параметр позволяет задать расположение XML-файлов, используемых по умолчанию, а затем начать миграцию. Если путь не указан, USMT будет ссылаться на каталог, в котором размещены двоичные файлы USMT. Параметр /auto аналогичен использованию следующих параметров: /i:MigDocs.xml , /i:MigApp.xml /v:5. |
| /genmigxml:path to a file | Этот параметр указывает, что команда ScanState должна использовать средство поиска документов для экспорта XML-файла с целью переноса всех файлов на компьютер, на котором выполняется команда ScanState. |
| /targetwindows8 |
Оптимизирует Scanstate.exe при использовании USMT 10.0 для переноса пользовательской среды в Windows 8 или Windows 8.1 вместо Windows 10. Этот параметр командной строки следует использовать в следующих случаях: Для создания файла Config.xml с использованием параметра /genconfig. Использование параметра /targetwindows8 оптимизирует файл Config.xml так, что он содержит только компоненты, связанные с Windows 8 или Windows 8.1. Для создания хранилища миграции. Использование параметра /targetwindows8 гарантирует сбор средством ScanState правильного набора параметров ОС. Без параметра командной строки /targetwindows8 некоторые параметры могут быть утеряны во время миграции. |
| /targetwindows7 |
Оптимизирует Scanstate.exe при использовании USMT 10.0 для переноса пользовательской среды в Windows 7 вместо Windows 10. Этот параметр командной строки следует использовать в следующих случаях: Для создания файла Config.xml с использованием параметра /genconfig. Использование параметра /targetwindows7 оптимизирует файл Config.xml так, что он содержит только компоненты, связанные с Windows 7. Для создания хранилища миграции. Использование параметра /targetwindows7 гарантирует сбор средством ScanState правильного набора параметров ОС. Без параметра командной строки /targetwindows7 некоторые параметры могут быть утеряны во время миграции. |
| /localonly |
Переносит только файлы локального компьютера, независимо от правил в XML-файлах, указанных в командной строке. Этот параметр следует использовать, если нужно исключить данные, хранящиеся на съемных носителях исходного компьютера, таких как USB-устройства флэш-памяти (UFD), некоторые внешние жесткие диски и т. д., а также при наличии сетевых дисков, подключенных к исходному компьютеру. Если параметр /localonly не указан, то при использовании команды ScanState будет выполнено копирование файлов из этих переносных или сетевых дисков в хранилище. Все, что не воспринимается операционной системой как фиксированный жесткий диск, будет исключено при помощи /localonly. В некоторых случаях внешние жесткие диски большой емкости рассматриваются как встроенные. Такие диски могут быть явно исключены из процесса миграции с помощью файла custom.xml |
| /listfiles:<FileName> | Вы можете использовать параметр командной строки /listfiles с командой ScanState для создания текстового файла, в котором приводится список всех файлов, включенных в миграцию. |
| /l:[Path\]FileName |
Задает расположение и имя журнала команды ScanState. Файлы журнала нельзя сохранять в каталоге StorePath. Path может представлять собой относительный или полный путь. Если не указать переменную Path, то журнал будет создан в текущем каталоге. Вы можете использовать параметр /v для регулировки объема выводимых данных. Если вы запустите команды ScanState или LoadState из совместного сетевого ресурса, вы должны указать этот параметр, иначе в USMT произойдет сбой со следующей ошибкой: "USMT не удалось создать файл журнала". Чтобы исправить неполадку, используйте команду /l:scan.log. |
| /v:<VerbosityLevel> |
Управляет детализацией выводимых данных в файле журнала команды ScanState. Значение по умолчанию — 0. Можно присвоить параметру VerbosityLevel одно из следующих значений.
|
| progress:[Path\]FileName | Создает необязательный журнал хода выполнения. Файлы журнала нельзя сохранять в каталоге StorePath. Path может представлять собой относительный или полный путь. Если не указано значение переменной Path, то в текущем каталоге создается FileName . |
| /c |
При указании этого параметра команда ScanState будет работать даже при возникновении некритических ошибок. Файлы и параметры, вызвавшие ошибку, записываются в журнал хода выполнения. Например, если имеется большой файл, который не помещается в хранилище, команда ScanState внесет ошибку в журнал и продолжит миграцию. Кроме того, если файл открыт или используется каким-либо приложением, USMT может не справиться с перемещением файла и запишет соответствующую ошибку в журнал. Без использования параметра /c команда ScanState выполнит выход при возникновении первой ошибки. Воспользуйтесь новым разделом <ErrorControl> в файле Config.xml, чтобы указать, какие ошибки чтения или записи файла или реестра можно пропустить, а какие должны привести к сбою миграции. Это позволяет использовать параметр командной строки /c для безопасного пропуска всех ошибок ввода-вывода в вашей среде. Кроме того, параметр /genconfig теперь создает образец раздела <ErrorControl>, который включается путем указания сообщений об ошибках и желаемого поведения в файле Config.xml. |
| /r:<TimesToRetry> |
Задает количество повторов операции при возникновении ошибки во время сохранения пользовательской среды на сервере. По умолчанию выполняется три повтора. Этот параметр полезен в средах с ненадежным подключением к сети. При сохранении состояния пользователя параметр /r не удастся использовать для восстановления данных, утраченных вследствие сетевого сбоя, например неисправности или отключения сетевого кабеля или при сбое подключения виртуальной частной сети. Параметр повтора предназначен для использования в крупных сетях с интенсивным трафиком, в которых качество соединения удовлетворительно, но наблюдаются проблемы из-за задержек передачи данных. |
| /w:<SecondsBeforeRetry> | Определяет время (в секундах) между повторными попытками операций с файлами по сети. По умолчанию используется значение "1 секунда". |
| /p:<pathToFile> |
При запуске команды ScanState будет создан XML-файл в заданном местоположении. В этом XML-файле содержатся улучшенные оценки пространства, необходимого для размещения хранилища миграции. Следующий пример иллюстрирует создание этого XML-файла. Scanstate.exe C:\MigrationLocation [additional parameters] /p:"C:\MigrationStoreSize.xml" Чтобы сохранить функциональность существующих приложений или скриптов, которым необходимо предыдущее поведение USMT, вы можете использовать параметр /p без указания "pathtoafile" в USMT. Если указан только параметр /p, оценка пространства создается точно так же, как и в выпусках USMT3.x. |
| /all |
Переносит всех пользователей на данном компьютере. USMT переносит все учетные записи пользователей на компьютере, если не указать, что ту или иную учетную запись необходимо исключить при помощи параметра /ue или /uel. Поэтому данный параметр не обязательно указывать в командной строке. Но если выбрать параметр /all, то вы не сможете воспользоваться параметрами /ui, /ue или /uel. |
|
/ui:<DomainName>\<UserName> или /ui:<ComputerName>\<LocalUserName> |
(Включение пользователя) Выполняет перенос указанных пользователей. По умолчанию в перенос включены все пользователи. Поэтому этот параметр полезен только при использовании с параметрами /ue или /uel. Можно указать несколько параметров /ui, но нельзя использовать параметр /ui с параметром /all. DomainName и UserName могут содержать подстановочный знак звездочки (*). Если имя пользователя содержит пробелы, необходимо заключить его в кавычки. Примечание Чтобы добавить только пользователя User2 из домена Fabrikam, введите команду: /ue:*\* /ui:fabrikam\user2 Чтобы перенести всех пользователей домена Fabrikam и только те учетные записи пользователей других доменов, которые были активны или каким-либо образом изменялись в течение последних 30 дней, введите команду: /uel:30 /ui:fabrikam\* В этом примере учетная запись пользователя домена Contoso, последние изменения в которой сделаны 2 месяца назад, не будет участвовать в миграции. Дополнительные примеры см. в описаниях параметров /ue и /ui в следующей таблице. |
|
/uel:<NumberOfDays> или /uel:<YYYY/MM/DD> или /uel:0 |
(Исключение пользователей на основании последнего входа в систему) Переносит пользователей, которые выполнили вход на исходный компьютер в течение указанного периода времени, на основании даты, указанной в разделе Last Modified файла Ntuser.dat на исходном компьютере. Параметр /uel действует как правило включения. Например, параметр /uel:30 переносит пользователей, выполнивших вход, или пользователей, чья учетная запись была изменена в пределах 30 дней от даты запуска команды ScanState. Можно указать количество дней или дату. Вы не можете использовать этот параметр с параметром /all. USMT извлекает сведения о последнем времени входа из локального компьютера, чтобы компьютеру не требовалось подключение к сети при запуске этого параметра. Кроме того, если пользователь домена выполнил вход на другом компьютере, этот экземпляр входа не будет рассматриваться в USMT. Примечание /uel:0 переносит всех пользователей, выполнивших вход к текущему моменту. /uel:90 переносит пользователей, которые выполнили вход или учетная запись которых была изменена другим образом за последние 90 дней. /uel:1 переносит пользователей, учетные записи которых изменялись в течение последних 24 часов. /uel:2002/1/15 осуществляет перенос пользователей, которые выполняли вход или учетные записи которых изменялись 15 января 2002 г. или позже. Пример. scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0 |
|
/ue:<DomainName>\<UserName> -или- /ue:<ComputerName>\<LocalUserName> |
(Исключение пользователя) Исключает указанных пользователей из переноса. Вы можете указать несколько параметров /ue. Вы не можете использовать этот параметр с параметром /all. <DomainName> и <UserName> могут содержать подстановочный знак звездочки (*). Если имя пользователя содержит пробелы, его необходимо заключить в кавычки. Пример. scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /ue:contoso\user1 |
| /efs:hardlink | Создает жесткую связь с файлом системы EFS вместо того, чтобы его копировать. Используйте только с параметрами /hardlink и /nocompress. |
| /efs:abort | Приводит к сбою команды ScanState с кодом ошибки, если обнаруживается зашифрованный файл EFS на исходном компьютере. Включен по умолчанию. |
| /efs:skip | Заставляет команду ScanState пропускать файлы EFS. |
| /efs:decryptcopy | Указывает команде ScanState, что нужно расшифровать файл, если это возможно, перед его сохранением в хранилище миграции, или на сбой в случае, если файл расшифровать не удается. Если команда ScanState выполняется успешно, файл будет помещен в хранилище миграции в незашифрованном виде, а сразу после запуска команды LoadState этот файл будет скопирован на целевой компьютер. |
| /efs:copyraw |
Задает команде ScanState копирование файлов в зашифрованном виде. На целевом компьютере файлы недоступны до тех пор, пока не будут перенесены сертификаты EFS. Сертификаты EFS будут перенесены автоматически; однако по умолчанию USMT завершит работу при обнаружении зашифрованного файла, если не указан параметр /efs. Поэтому вам необходимо указать параметр //efs:copyraw для команды ScanState, чтобы зашифрованные файлы были перенесены. Тогда при выполнении команды LoadState на целевом компьютере зашифрованный файл и сертификат файловой системы EFS будут перенесены автоматически. Пример. ScanState /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /efs:copyraw Важно |
| /? или /help | Выводит справочные сведения в командной строке. |
Использование /ui и /ue
Следующие примеры применимы к параметрам /ui и /ue. Можно заменить параметр /ue на параметр /ui , чтобы включить, а не исключить указанных пользователей.
| Команда | Результат |
| /ue:"fabrikam\user one" | Исключить пользователя домена Fabrikam с именем User One. |
| /ue:fabrikam\user1 | Исключить пользователя домена Fabrikam с именем User1. |
| /ue:%computername%\user1 | Исключить локального пользователя с именем User1. |
| /ue:Domain\* | Исключить всех пользователей домена. |
| /ue:%computername%\* | Исключить всех локальных пользователей. |
| /ue:*\user* | Исключить пользователей всех доменов, имена которых User1, User2 и т. д. |
| /ue:*\* /ui:fabrikam\user2 | Добавить только пользователя User2 домена Fabrikam и исключить всех остальных. |
| /ue:*\* /ui:user1 | Добавить только локального пользователя с именем User1 и исключить всех остальных. |
| Добавить только пользователей домена Contoso, за исключением Contoso\User1. |
Такое поведение невозможно реализовать с помощью одной команды. Чтобы перенести этот набор пользователей, необходимо выполнить следующие действия. В командной строке ScanState введите /ue:*\* /ui:contoso\*. В командной строке LoadState введите /ue:contoso\user1. |
| /ue:*\* /ui:%computername%\* | Добавить только локальных пользователей (не пользователей домена). |
Параметры /uel, /ue и /ui можно использовать вместе, чтобы переместить только определенных пользователей.
Параметр /ui имеет преимущество перед параметрами /ue и /uel. Если пользователь указан для включения при помощи параметра /ui, при этом он также указан для исключения при помощи параметра /ue или /uel, пользователь будет включен в миграцию. Например, если указать /ui:contoso\* /ue:contoso\user1, то User1 будет перенесен, поскольку параметр /ui имеет приоритет перед параметром /ue.
Параметр /uel имеет преимущество в сравнении с параметром /ue. Если пользователь выполнил вход в течение указанного временного интервала, указанного в параметре /uel, то профиль этого пользователя будет перенесен, даже если он исключен при помощи параметра /ue. Например, если вы укажете параметр /ue:fixed\user1 /uel:14, User1 будет перенесен, если он выполнил вход на компьютере за последние 14 дней.
Комментарии
I have described everything in as much detail as possible.
more?
RSS лента комментариев этой записи