Командная строка USB Safely Remove позволяет оперировать устройствами из
консоли командной строки. Она является полноценным консольным приложением и
позволяет осуществить почти все те-же действия, что и GUI версия программы:
просмотреть список устройств, остановить устройство, вернуть его обратно,
выяснить, какие процессы блокируют устройство.
Она полезна для использования в скриптах, которые взаимодействуют с
устройствами. Вот несколько примеров ее применения:
-
Бэкап данных на резервный винчестер и его автоматическое отключение
-
Скрипт, отключающий сначала TrueCrypt (средство для шифрования диска),
а потом извлекающий винчестер.
-
Тестирование ПО, работающего с USB
Командная строка реализована в виде отдельного консольного приложения usr.exe,
располагающегося в каталоге программы - %Program Files%\USB Safely Remove\
Общий синтаксис командной строки следующий:
usr <имя_команды> [параметры_команды] ,
где
имя_команды - одно из нижеперечисленных имен команд
параметры_команды - набор параметров
команды, например для команды stop - это имя устройства или буква диска
Допустимые команды:
stop | Останавливает устройство |
return | Возвращает устройство обратно |
list | Выводит список устройств |
wholocks | Выводит список процессов, мешающих отключить устройство или вернуть его обратно |
help <имя_команды> | Выводит справку по команде <имя_команды> |
help errs | Выводит перечень возвращаемых кодов ошибок (errorlevel) |
help | Выводит справку по всей командной строке |
Errorlevel возвращаемые командной строкой
0 - операция успешно завершена
1 - Устройство не было найдено
2 - Невозможно остановить устройство. Возникает в случае, когда устройство
заблокировано другой программой, или, когда устройство не предназначено для
остановки
3 - неверный синткасис команды
4 - неизвестная команда
5 - Невозможно найти процессы блокирующие устройство (при остановке устройства) или
его соседей (при возврате устройства). Либо, устройство уже
свободно для извлечения, либо его блокирует какой-то процесс запущенный с более
высокими привилегиями (например, под учетной записью System)
6 - Техническая ошибка во время поиска процессов заблокировавших устройство
stop
Предназначена для безопасного извлечения устройств.
Синтаксис:
usr stop <параметры_комманды>
Возможные <параметры_комманды>:
-d DriveLetter | Останавливает устройство по имени диска DriveLetter.
В качестве имени можно задать просто букву диска ("C"), букву и ":" ("C:"), а
также, путь к каталогу или файлу на диске
|
-n DeviceName | Останавливает устройство по его имени (можно
задать часть имени). Имя - это то имя, которое отображается коммандой usr list
|
Примеры:
"usr stop -d g:" | Останавливает устройство, которое имеет диск g:
|
"usr stop -n Sony" | Останавливает устройство, которое имеет в
названии слово "Sony"
|
return
Предназначена для возврата остановленного, но еще не извлеченного устройства обратно.
Синтаксис:
usr return <параметры_комманды>
Возможные <параметры_комманды>:
-d DriveLetter | Возвращает устройство по имени диска DriveLetter.
В качестве имени можно задать просто букву диска ("C"), букву и ":" ("C:"), а
также, путь к каталогу или файлу на диске
|
-n DeviceName | Останавливает устройство по его имени (можно
задать часть имени). Имя - это то имя, которое отображается коммандой usr list
|
Примеры:
"usr return -d g:" | Возвращает обратно устройство, которое имеет диск g:
|
"usr return -n Sony" | Возвращает обратно устройство, которое имеет в
названии слово "Sony"
|
list
Выводит список отключаемых устройств
Синтаксис:
usr list [параметры_комманды]
Возможные "параметры_комманды":
-a |
Выводит все отключаемые устройства (эта опция включена по умолчанию)
|
-s | Выводит только разрешенные для остановки
устройства (те, которые есть в меню)
|
-u | Выводит только запрещенные для остановки
устройства (те, которые удалены из меню)
|
Когда не задана ни одна опция, то команда выводит все устройства -
так, как будто была включена опция "-a"
Примеры:
"usr list" | Выводит на экран все устройства
|
"usr list -s" | Выводит на экран только отображаемые устройства
|
wholocks
Выводит список процессов, которые мешают безопасно извлечь устройство или вернуть его обратно
Если устройство остановлено но не извлечено, то данная команда
будет возвращать список процессов, блокирующих соседние на USB хабе
устройства. О том, зачем так делается,
см. здесь.
Синтаксис:
usr wholocks <параметры_комманды>:
Возможные <параметры_комманды>:
-d DriveLetter |
Находит устройство по букве диска DriveLetter и выводит все процессы, блокирующие его
|
-n DeviceName |
Находит устройство по имени устройства DeviceName
(полному или частичному) и выводит все процессы, блокирующие его
|
Примеры:
"usr wholocks -d g:" | Выводит процессы, которые блокируют устройство
имеющее диск g: |
|
"usr wholocks -n Sony" | Выводит процессы, которые блокируют
устройство имеющее в названии слово "Sony"
|
|