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

Синтаксис ScanState

  • Статья

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

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

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

Прежде чем приступить к работе

Синтаксис

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

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

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

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

Параметры зашифрованных файлов

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

Прежде чем приступить к работе

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

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

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

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

    Важно!

    Windows XP и Windows Vista(R) поддерживаются только в качестве операционных систем исходного компьютера.

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

  • Для того чтобы собрать учетные записи домена, исходному компьютеру необязательно иметь доступ к контроллеру домена. Для доступа к этим функциям не требуется дополнительная конфигурация.

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

  • Каталог, в котором сохранено хранилище миграции, не сканируется. Например, если хранилище миграции находится в корне диска D, этот диск и все его подкаталоги не сканируются.

Синтаксис

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

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

scanstate [ПутьХранилища] [/i:[Путь\]ИмяФайла] [/o] [/v:УровеньДетализации] [/nocompress] [/localonly] [/encrypt /key:СтрокаКлюча|/keyfile:[Путь\]ИмяФайла] [/l:[Путь\]ИмяФайла] [/progress:[Путь\]ИмяФайла] [/r:КоличествоПовторов] [/w:СекундДоПовтора] [/c] [/p] [/all] [/ui:[ИмяДомена|ИмяКомпьютера\]ИмяПользователя] [/ue:[ИмяДомена|ИмяКомпьютера\]ИмяПользователя] [/uel:КоличествоДней|ГГГГ/ММ/ДД|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Путь\]ИмяФайла[/config:[Путь\]ИмяФайла] [/?|help]

Примеры:

  • Чтобы создать файл 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"

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

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

ПутьХранилища

Указывает папку для сохранения файлов и параметров. Обратите внимание, что в качестве значения ПутьХранилища не может быть указан путь c:\. Параметр ПутьХранилища обязателен для указания в команде ScanState, кроме тех случаев, когда используется параметр /genconfig. Нельзя указывать более одного расположения ПутьХранилища.

/o

Необходим для перезаписи любых существующих данных в хранилище миграции или файле Config.xml. Если параметр не указан, в том случае когда хранилище миграции уже содержит данные, команда ScanState завершится с ошибкой. Этот параметр нельзя использовать в командной строке более одного раза.

/vsc

Этот параметр включает службу теневого копирования томов для переноса заблокированных или используемых файлов. Этот параметр командной строки устраняет большинство ошибок блокировки файлов, которые обычно обнаруживает раздел <ErrorControl>.

Этот параметр может использоваться только с исполняемым файлом ScanState и не может сочетаться с параметром /hardlink.

/hardlink

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

/encrypt [{/key:<СтрокаКлюча> | /keyfile:<файл>]}

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

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

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

Мы рекомендуем указывать в качестве параметра СтрокаКлюча строку длиной не менее 8 символов, но не более 256 символов. Параметры /key и /keyfile нельзя использовать в одной командной строке. Параметры /encrypt и /nocompress нельзя использовать в одной командной строке.

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

Следующий пример иллюстрирует использование команды ScanState и параметра /key.

scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /encrypt /key:mykey

/encrypt:<УровеньШифрования>

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

/nocompress

Отключает сжатие данных и сохраняет файлы в скрытой папке с именем "File" по адресу ПутьХранилища\USMT. По умолчанию сжатие включено. При сочетании параметра /nocompress с параметром /hardlink создается хранилище миграции с жесткими связями. Несжатое хранилище можно использовать для просмотра сохраненных данных Средство миграции пользовательской среды, устранения неполадок или проверки файлов антивирусной служебной программой. Этот параметр следует использовать только в тестовых средах. В ходе фактической миграции мы рекомендуем использовать сжатое хранилище, если только вы не сочетаете параметр /nocompress с параметром /hardlink.

Параметры /nocompress и /encrypt нельзя использовать вместе в одном операторе командной строки. Тем не менее, если принято решение переносить несжатое хранилище, команда LoadState перенесет каждый файл непосредственно из хранилища в соответствующее расположение на конечном компьютере без использования временного расположения.

Примеры:

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

Выполнение команды ScanState в автономной системе Windows

Команду ScanState можно выполнить в среде предустановки Windows. Средство миграции пользовательской среды также поддерживает перенос данных из предыдущих установок Windows, содержащихся в каталогах Windows.old. В качестве автономного каталога может выступать каталог Windows, если команда ScanState выполняется в среде предустановки Windows, или каталог Windows.old, если команда ScanState выполняется в среде Windows.

Выполнение команды ScanState в автономном образе Windows имеет ряд преимуществ, в том числе следующие.

  • Улучшение производительности.

    Так как среда предустановки Windows является тонкой операционной системой, в ней меньше запущенных служб. В этой среде команда ScanState имеет больше доступа к локальным аппаратным ресурсам, позволяя ScanState быстрее выполнять миграцию.

  • Упрощенный процесс развертывания "узел-узел".

    Перенос данных из каталога Windows.old упрощает процесс развертывания по схеме "узел-узел", позволяя выполнять миграцию после установки новой операционной системы.

  • Повышение успешности миграции.

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

  • Возможность восстановления компьютера, не способного загрузиться.

    В автономном режиме есть возможность восстановить и перенести данные с компьютера, не способного загрузиться.

Параметры автономной миграции

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

/offline: "путь к автономному XML-файлу"

Этот параметр используется для задания пути к автономному XML-файлу, в котором могут быть указаны другие параметры автономной миграции, например автономный каталог Windows или какое-либо перенаправление домена или папок, необходимое для миграции.

/offlinewindir: "путь к каталогу Windows"

Этот параметр задает автономный каталог Windows, из которого команда ScanState извлекает пользовательскую среду. В качестве автономного каталога может выступать каталог Windows.old, если команда ScanState выполняется в среде Windows, или каталог Windows, если команда ScanState выполняется в среде предустановки Windows.

/offlinewinold: "каталог Windows.old"

Этот параметр командной строки осуществляет переход в автономный режим миграции и начинает перенос данных из указанного расположения. Он предназначен для использования только в сценариях миграции Windows.old, когда выполняется перенос данных из каталога Windows.old.

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

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

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

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

(включение)

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

/genconfig:[Путь\]ИмяФайла

(Создать Config.xml)

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

После создания этого файла необходимо его применить, выполнив команду ScanState с параметром /config.

Единственными параметрами, которые можно указывать вместе с этим параметром, являются /i, /v и /l. Нельзя указывать параметр ПутьХранилища, потому что при использовании параметра /genconfig хранилище не создается. В качестве значения переменной Путь может быть указан относительный или полный путь. Если переменная Путь не задана, файл ИмяФайла будет создан в текущем каталоге.

Примеры:

  • Следующий пример иллюстрирует создание файла Config.xml в текущем каталоге.

    scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13

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

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

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

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

/genmigxml: путь к файлу

Этот параметр указывает, что команда ScanState должна использовать средство поиска документов для создания и экспорта XML-файла, определяющего порядок переноса всех файлов с компьютера, на котором выполняется команда ScanState.

/localonly

Переносит только файлы локального компьютера независимо от правил в XML-файлах, указанных в командной строке. Этот параметр следует использовать, когда необходимо исключить данные, хранящиеся на съемных носителях исходного компьютера, таких как USB-устройства флэш-памяти (UFD), некоторые внешние жесткие диски и т. д., а также при наличии сетевых дисков, подключенных к исходному компьютеру. Если параметр /localonly не указан, команда ScanState скопирует файлы с этих съемных или сетевых дисков в хранилище.

Все носители, не опознанные ОС как встроенные диски, будут исключены параметром /localonly. В некоторых случаях внешние жесткие диски большой емкости рассматриваются как встроенные. Такие диски могут быть явно исключены из процесса миграции с помощью файла custom.xml. Подробнее об исключении всех файлов заданного диска см. в разделе Исключение файлов и параметров.

Параметр командной строки /localonly добавляет или исключает данные для переноса, как показано в следующей таблице.

 

Тип носителя Поведение с /localonly

Съемные носители, например USB-устройства флэш-памяти

Исключаются

Сетевые диски

Исключаются

Встроенные диски

Добавляются

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

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

Примечание

Журнал команды ScanState создается по умолчанию, но с помощью параметра /l можно задать имя и расположение журнала.

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

/listfiles:<ИмяФайла>

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

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

Задает расположение и имя журнала команды ScanState.

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

Если команды ScanState или LoadState выполняются из общего сетевого ресурса, необходимо указать этот параметр, иначе работа Средство миграции пользовательской среды завершится со следующей ошибкой: "Средству миграции пользовательской среды не удалось создать файлы журнала". Для исправления ошибки используйте параметр /l:scan.log.

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

(Verbosity)

Управляет детализацией выводимых данных в файле журнала команды ScanState. По умолчанию значение равно 0.

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

 

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

0

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

1

Включает вывод детальных сведений.

4

Включает вывод сведений об ошибках и состоянии.

5

Включает вывод детальных сведений и сведений о состоянии.

8

Включает вывод сведений об ошибках для отладчика.

9

Включает вывод детальных сведений для отладчика.

12

Включает вывод сведений об ошибках и состоянии для отладчика.

13

Включает вывод детальных сведений, сведений о состоянии и сведений для отладчика.

 
          </div>
          <p>Примеры:</p>
          <p>
            <code>scanstate \\server\share\migration\mystore /v:13 /i:migdocs.xml /i:migapp.xml</code>
          </p>
          <p>
            
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/progress</strong>:[<em>Path\</em>]<em>ИмяФайла</em></p>
        </td>
        <td colspan="1">
          <p>Создает необязательный журнал хода выполнения. Файлы журналов нельзя хранить в папке <em>StorePath</em>. В качестве значения переменной <em>Путь</em> может быть указан относительный или полный путь. Если переменная <em>Путь</em> не задана, файл <em>ИмяФайла</em> будет создан в текущем каталоге.</p>
          <p>Примеры:</p>
          <p>
            <code>scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/c</strong>
          </p>
        </td>
        <td colspan="2">
          <p> Если указан этот параметр, команда <strong>ScanState</strong> продолжит работу даже при возникновении некритических ошибок. Сведения о всех файлах и параметрах, послуживших причиной ошибки, будут занесены в журнал хода выполнения. Например, при попытке переноса большого файла, не умещающегося в хранилище, команда <strong>ScanState</strong> занесет в журнал сведения об ошибке и продолжит миграцию. Кроме того, если файл открыт или используется приложением, Средство миграции пользовательской среды может не выполнить его перенос и сделает в журнале запись об ошибке. Если параметр <strong>/c</strong> не указан, команда <strong>ScanState</strong> завершит выполнение при первой ошибке.</p>
          <p>Новый раздел <strong>&lt;ErrorControl&gt;</strong> в файле Config.xml можно использовать для того, чтобы указать, какие ошибки чтения/записи файлов или реестра можно безопасно проигнорировать, а какие могут привести к ошибке миграции. При этих условиях параметр командной строки <strong>/c</strong> обеспечит безопасный пропуск всех ошибок ввода/вывода в вашей среде. Кроме того, теперь параметр<strong>/genconfig</strong> создает образец раздела <strong>&lt;ErrorControl&gt;</strong>, который активируется при помощи определения сообщений об ошибках и необходимых действий в файле 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>Задает количество повторов операции при возникновении ошибки сохранения пользовательской среды на сервере. По умолчанию выполняется три повтора. Этот параметр бывает полезен в средах с ненадежным сетевым соединением.</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>
          <p>
            <strong>/p:</strong>
            <em>&lt;ПутьФайла&gt;</em>
          </p>
        </td>
        <td>
          <p>При запуске команда <strong>ScanState</strong> создает XML-файл по указанному пути. В этом XML-файле содержатся улучшенные оценки пространства, необходимого для размещения хранилища миграции. Следующий пример иллюстрирует создание этого XML-файла.</p>
          <p>
            <code>Scanstate.exe C:\MigrationLocation [additional parameters]</code>
          </p>
          <p>
            <code>/p:"C:\MigrationStoreSize.xml"</code>
          </p>
          <p>Подробнее см. в разделе <a runat="server" href="hh825132(v=win.10).md">Определение размера хранилища переноса</a>.</p>
          <p>Чтобы сохранить функциональность существующих приложений или сценариев, для которых требуется ранее принятое поведение Средство миграции пользовательской среды, в Средство миграции пользовательской среды можно использовать параметр <strong>/p</strong>, не задавая <em>"путьфайла"</em>. Если указан только параметр <strong>/p</strong>, оценка объема хранилища будет производиться так же, как и в выпусках USMT3.x.</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: <ИмяКомпьютера>\<ИмяЛокальногоПользователя>

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

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

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

Примеры:

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

    /ue:*\* /ui:fabrikam\user2

  • Чтобы перенести всех пользователей домена Fabrikam и только те учетные записи пользователей других доменов, которые были активны или каким-либо образом изменялись в течение последних 30 дней, введите команду:

    /uel:30 /ui:fabrikam\*

    В этом примере учетная запись пользователя домена Contoso, последние изменения в которой были сделаны 2 месяца назад, не будет участвовать в миграции.

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

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

или

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

или

/uel:0

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

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

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

noteПримечание
Параметр /uel недопустим при переносе в автономном режиме.

  • /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: <ИмяДомена>\<ИмяПользователя>

-или-

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

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

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

Примеры:

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

Использование /ui и /ue

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

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

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

/ue:"fabrikam\user one"

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

/ue:fabrikam\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:fixed\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%\*

Параметры зашифрованных файлов

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

Подробнее см. в разделе Перенос файлов и сертификатов файловой системы EFS.

Примечание

При миграции в Windows Vista, Windows 7 или Windows 8 сертификаты файловой системы EFS будут перенесены автоматически. Таким образом, для переноса зашифрованных файлов с командой ScanState следует указывать параметр /efs:copyraw.

Предупреждение

Будьте внимательны при переносе зашифрованных файлов. Если перенести зашифрованный файл, но не перенести вместе с ним сертификат, после миграции конечные пользователи не смогут получить к нему доступ.

Параметр командной строки Объяснение

/efs:hardlink

Создает жесткую связь с файлом системы EFS вместо того, чтобы его копировать. Используйте только с параметрами /hardlink и /nocompress.

/efs:abort

Вызывает завершение команды ScanState с кодом ошибки при обнаружении на исходном компьютере файла шифрованной файловой системы (EFS). Включен по умолчанию.

/efs:skip

Заставляет команду ScanState игнорировать файлы EFS.

/efs:decryptcopy

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

/efs:copyraw

Заставляет команду ScanState копировать файлы в зашифрованном виде. На конечном компьютере файлы будут недоступны до тех пор, пока не будут перенесены сертификаты EFS. Сертификаты EFS будут перенесены автоматически. Тем не менее, по умолчанию команда Средство миграции пользовательской среды завершает выполнение при обнаружении зашифрованного файла, если не указан параметр /efs. Таким образом, для переноса зашифрованного файла с командой ScanState следует указывать параметр /efs:copyraw. Тогда при выполнении команды LoadState зашифрованный файл и сертификат EFS будут автоматически перенесены.

Примеры:

ScanState /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /efs:copyraw

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

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

В следующей таблице показано, какие параметры командной строки несовместимы с командой ScanState. Если ячейка таблицы, соответствующая отдельной комбинации параметров, пуста, данные параметры совместимы и могут использоваться совместно. Символ X означает, что параметры несовместимы. Например, параметр /nocompress нельзя указывать в сочетании с параметром /encrypt.

Параметр командной строки /keyfile /nocompress /genconfig /all

/i

/o

/v

/nocompress

X

Н/Д

/localonly

X

/key

X

X

/encrypt

Обязательный*

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

/efs:<параметр>

X

/genconfig

Н/Д

/config

X

<ПутьХранилища>

X

Примечание

Необходимо указать параметр /key или /keyfile с параметром /encrypt.

См. также

Понятия

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