Введение
Пользовательский интерфейс
Как...
Покупка

Справка > Командная строка - для чего нужна и как использовать?

Для чего нужна командная строка?

Командная строка USB Safely Remove позволяет оперировать устройствами из консоли командной строки. Она является полноценным консольным приложением и позволяет осуществить почти все те-же действия, что и GUI версия программы: просмотреть список устройств, остановить устройство, вернуть его обратно, выяснить, какие процессы блокируют устройство.



Она полезна для использования в скриптах, которые взаимодействуют с устройствами. Вот несколько примеров ее применения:
  1. Бэкап данных на резервный винчестер и его автоматическое отключение
  2. Скрипт, отключающий сначала TrueCrypt (средство для шифрования диска), а потом извлекающий винчестер.
  3. Тестирование ПО, работающего с 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

Выводит список процессов, которые мешают безопасно извлечь устройство или вернуть его обратно

Синтаксис:
usr wholocks <параметры_комманды>:
Возможные <параметры_комманды>:
-d DriveLetter Находит устройство по букве диска DriveLetter и выводит все процессы, блокирующие его
-n DeviceName Находит устройство по имени устройства DeviceName (полному или частичному) и выводит все процессы, блокирующие его
Примеры:
"usr wholocks -d g:" Выводит процессы, которые блокируют устройство имеющее диск g:
"usr wholocks -n Sony" Выводит процессы, которые блокируют устройство имеющее в названии слово "Sony"