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

Синтаксис LoadState

  • Статья

Назначение: Windows 7, Windows 8, Windows 8.1, Windows Vista

В этом разделе рассматривается синтаксис и параметры команды LoadState.

В этом разделе:

Приступая к работе

Синтаксис

Параметры хранилища

Параметры правил переноса

Параметры наблюдения

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

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

Приступая к работе

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

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

  • Подробно о программных требованиях для выполнения команды LoadState см. в разделе Требования средства миграции пользовательской среды.

  • После запуска команды LoadState необходимо выйти из системы. Ряд параметров (например, параметры шрифтов, обоев и экранной заставки) вступят в силу только при следующем входе пользователя в систему.

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

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

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

Синтаксис

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

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

loadstate Путь к хранилищу [/i:[Путь\]Имя файла] [/v:Уровень детализации] [/nocompress] [/decrypt /key:Строка ключа|/keyfile:[Путь\]Имя файла] [/l:[Путь\]Имя файла] [/progress:[Путь\]Имя файла] [/r:Число повторов] [/w:Время ожидания в сек.] [/c] [/all] [/ui:[Имя домена|Имя компьютера\]Имя пользователя] [/ue:[[Имя домена|Имя компьютера\]Имя пользователя] [/uel:Количество дней|ГГГГ/ММ/ДД|0] [/md:Старый домен:Новый домен] [/mu:Старый домен\Старое имя пользователя:[Новый домен\]Новое имя пользователя] [/lac:[Пароль]] [/lae] [/config:[Путь\]Имя файла] [/?|help]

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

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

Параметры хранилища

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

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

Путь к хранилищу

Определяет папку, в которой будут сохранены файлы и параметры. При использовании команды LoadState параметр Путь к хранилищу является обязательным. Можно указать только один параметр Путь к хранилищу.

/decrypt /key:Строка ключа

или

/decrypt /key:"Строка ключа"

или

/decrypt /keyfile:[Путь\]Имя файла

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

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

  • Параметр "/keyfile:Путь и имя файла" определяет текстовый файл (TXT-файл), содержащий ключ шифрования.

Длина параметра Строка ключа не должна превышать 256 символов.

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

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

> [!IMPORTANT] > Этот параметр следует использовать с осторожностью, так как все, у кого есть доступ к сценарию командной строки LoadState, также будут иметь доступ к ключу шифрования. >

Пример.

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

/decrypt: "Стойкость шифрования"

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

/hardlink

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

/nocompress

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

Пример.

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

Параметры правил переноса

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

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

/i:[Путь\]Имя файла

(include)

Указывает XML-файл, содержащий правила, которые определяют, какое состояние следует перенести. Этот параметр можно указать несколько раз, чтобы включить в процесс переноса все XML-файлы (MigApp.xml, MigSys.xml, MigDocs.xml и все созданные вами пользовательские XML-файлы). В качестве значения переменной Путь может быть указан относительный или полный путь. Если переменная Путь не задана, файл, указанный для параметра Имя файла, должен находиться в текущем каталоге.

Подробнее о том, какие файлы следует указывать, см. в разделе "XML-файлы" темы Вопросы и ответы.

/config:[Путь\]Имя файла

Определяет файл Config.xml, который должен использоваться в команде LoadState. Этот параметр можно указать в командной строке только один раз. В качестве значения переменной Путь может быть указан относительный или полный путь. Если переменная Путь не задана, файл, на который указывает параметр Имя файла, должен находиться в текущем каталоге.

В следующем примере демонстрируется перенос файлов и параметров по правилам, указанным в файлах 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: "Путь к файлам сценариев"

Этот параметр позволяет указать расположение XML-файлов по умолчанию и затем запустить процесс переноса. Если путь не указан, Средство миграции пользовательской среды будет использовать каталог, в котором размещены двоичные файлы Средство миграции пользовательской среды. Параметр /auto оказывает такое же действие, как и следующие параметры: /i:MigDocs.xml/i:MigApp.xml /v:5.

Параметры наблюдения

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

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

/l:[Путь\]Имя файла

Определяет расположение и имя файла журнала LoadState. Файлы журналов нельзя хранить в папке StorePath. В качестве значения переменной Путь может быть указан относительный или полный путь. Если переменная Путь не задана, журнал будет создан в текущем каталоге. Чтобы задать объем выводимых данных, можно использовать параметр /v.

Если команда LoadState запускается с общего сетевого ресурса, этот параметр является обязательным. В противном случае возникнет ошибка Средство миграции пользовательской среды "USMT was unable to create the log file(s)" (Средству миграции пользовательской среды не удалось создать файлы журнала). Для исправления ошибки используйте параметр /l:load.log.

/v: <Уровень детализации>

(Verbosity)

Активирует подробный вывод данных в файл журнала LoadState. Значение по умолчанию – "0".

Для параметра Уровень детализации можно задать одно из следующих значений.

 

Уровень Объяснение

0

Включает только стандартные ошибки и предупреждения.

1

Включает режим подробного протоколирования.

4

Включает режим протоколирования отчетов об ошибках и состояниях.

5

Включает режим подробного протоколирования состояния.

8

Активирует вывод ошибок в отладчик.

9

Активирует вывод подробного отчета в отладчик.

12

Активирует вывод отчета об ошибке и состоянии в отладчик.

13

Включает режим подробного отчета, отчета о состоянии и отчета отладчика.

 
          </div>
          <p>Пример.</p>
          <p>
            <code>loadstate \\server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml</code>
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/progress:</strong>[<em>Путь\</em>]<em>Имя файла</em></p>
        </td>
        <td colspan="1">
          <p>Создает необязательный журнал хода выполнения. Файлы журналов нельзя хранить в папке <em>StorePath</em>. В качестве значения переменной <em>Путь</em> может быть указан относительный или полный путь. Если переменная <em>Путь</em> не задана, файл, указываемый для параметра <em>Имя файла</em>, будет создан в текущем каталоге.</p>
          <p>Пример.</p>
          <p>
            <code>loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
          </p>
        </td>
      </tr>
      <tr>
        <td>
          <p>
            <strong>/c</strong>
          </p>
        </td>
        <td>
          <p>Если указан этот параметр, команда <strong>LoadState</strong> продолжит работу даже в случае возникновения некритических ошибок. Файлы и параметры, вызвавшие ошибку, записываются в журнал хода выполнения. Например, если какой-либо файл окажется настолько большим, что для него не хватит места на компьютере, команда <strong>LoadState</strong> запишет ошибку в журнал и продолжит перенос. Без параметра <strong>/c</strong> команда <strong>LoadState</strong> завершит работу при первой же ошибке. Новый раздел &lt;<strong>ErrorControl</strong>&gt; в файле Config.xml можно использовать для того, чтобы указать, какие ошибки чтения/записи файлов или реестра можно безопасно проигнорировать, а какие могут привести к ошибке миграции. При этих условиях параметр командной строки <strong>/c</strong> обеспечит безопасный пропуск всех ошибок ввода-вывода в вашей среде. Кроме того, теперь параметр <strong>/genconfig</strong> создает образец раздела &lt;<strong>ErrorControl</strong>&gt;, который активируется путем определения сообщений об ошибках и необходимых действий в файле Config.xml.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/r:</strong>
            <em>&lt;Количество повторов&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Повтор)</strong>
          </p>
          <p>Определяет количество повторных попыток в случае ошибки при переносе пользовательской среды с сервера. Значение по умолчанию – "3". Этот параметр полезен в средах с ненадежным подключением к сети.</p>
          <p>При восстановлении пользовательской среды параметр <strong>/r</strong> не поможет восстановить данные, утерянные из-за сбоя сетевого оборудования, например из-за неисправного или отключенного сетевого кабеля либо сбоя подключения к виртуальной частной сети (VPN). Параметр повтора предназначен для использования в крупных сетях с интенсивным трафиком, в которых качество соединения удовлетворительно, но наблюдаются проблемы из-за задержек передачи данных.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/w:</strong>
            <em>&lt;Секунд до повтора&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Ожидание)</strong>
          </p>
          <p>Определяет время (в секундах) между повторными попытками операций с файлами по сети. По умолчанию – 1 секунда.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/?</strong> или <strong>/help</strong></p>
        </td>
        <td colspan="2">
          <p>Вывод справки в окне командной строки.</p>
        </td>
      </tr>
    </table>

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

По умолчанию осуществляется миграция всех пользователей. Существует только один способ указать, каких пользователей следует включить в перенос или исключить из него, – это применение описанных ниже параметров. Вы не можете исключить пользователей в XML-файлах переноса или при помощи файла Config.xml. Подробнее см. в разделе об Определение пользователей.

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

/all

Переносит всех пользователей на данном компьютере.

Средство миграции пользовательской среды переносит все учетные записи пользователей, за исключением случаев, когда какая-либо учетная запись специально исключена из переноса при помощи параметров /ue или /uel. Поэтому данный параметр не обязательно указывать в командной строке. Однако если вы решите использовать параметр /all, вы не сможете использовать параметры /ui, /ue и /uel.

/ui: Имя домена\Имя пользователя

или

/ui:"Имя домена\Имя пользователя"

или

/ui: Имя компьютера\Имя локального пользователя

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

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

Пример.

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

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

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

Дополнительные примеры см. в описаниях параметров /uel, /ue и /ui в следующей таблице.

/uel:<Количество дней>

или

/uel:<ГГГГ/ММ/ДД>

или

/uel:0

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

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

Можно указать количество дней или дату. Этот параметр нельзя использовать вместе с параметром /all. Средство миграции пользовательской среды получает сведения о последнем входе с локального компьютера, поэтому для применения этого параметра не обязательно подключение компьютера к сети. Кроме этого, если пользователь домена вошел в систему другого компьютера, Средство миграции пользовательской среды не будет учитывать этот экземпляр входа.

noteПримечание
Параметр /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:Имя домена\Имя пользователя

или

/ue:"Имя домена\Имя пользователя"

или

/ue:Имя компьютера\Имя локального пользователя

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

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

Пример.

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

Дополнительные примеры см. в описаниях параметров /uel, /ue и /ui в следующей таблице.

/md: Старый домен:Новый домен

или

/md: Имя локального компьютера:Новый домен

(Перемещение домена)

Определяет для данного пользователя новый домен. Используйте этот параметр в целях изменения домена для пользователей компьютера или переноса локальных пользователей на учетную запись домена. Старый домен может содержать подстановочный знак звездочки (*).

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

В случае конфликта между двумя командами /md применяется первое из указанных правил. Например, если вы укажете команды /md:corporate:fabrikam и /md:corporate:farnorth, пользователи домена Corporate будут сопоставлены с доменом Fabrikam.

noteПримечание
Если вы укажете несуществующий на исходном компьютере Старый домен, команда LoadState, на первый взгляд, успешно (без ошибок или предупреждений) выполнит задачу. Тем не менее в этом случае пользователи не будут перемещены в Новый домен, а останутся в исходном домене. Например, если вы допустите ошибку в слове "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: Старый домен\Старое имя пользователя:[Новый домен\]Новое имя пользователя

или

/mu: Старое имя локального пользователя:Новый домен\Новое имя пользователя

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

Пример.

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

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

/lac:[Пароль]

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

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

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

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

CautionВнимание
Переменную Пароль следует использовать с осторожностью, потому что она передается в виде обычного текста и может быть получена любым пользователем, имеющим доступ к компьютеру, на котором запущена команда 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

Путь к хранилищу

/md:

/mu

/lae

/lac

Примечание

С параметром /encrypt необходимо указывать либо параметр /key, либо параметр /keyfile.

См. также

Понятия

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