|
Командная строка USB Safely Remove позволяет оперировать устройствами из
консоли командной строки. Она является полноценным консольным приложением и
позволяет осуществить почти все те-же действия, что и GUI версия программы:
просмотреть список устройств, остановить устройство, вернуть его обратно,
выяснить, какие процессы блокируют устройство.
Она полезна для использования в скриптах, которые взаимодействуют с
устройствами. Вот несколько примеров ее применения:
-
Бэкап данных на резервный винчестер и его автоматическое отключение
-
Скрипт, отключающий сначала TrueCrypt (средство для шифрования диска),
а потом извлекающий винчестер.
-
Тестирование ПО, работающего с USB
Командная строка реализована в виде отдельного консольного приложения usr.exe,
располагающегося в каталоге программы - %Program Files%\USB Safely Remove\
Общий синтаксис командной строки следующий:
usr <имя_команды> [параметры_команды] ,
где
имя_команды - одно из нижеперечисленных имен команд
параметры_команды - набор параметров
команды, например для команды stop - это имя устройства или буква диска
Допустимые команды:
| stop | Останавливает устройство |
| forcedstop | Форсированно останавливает устройство |
| return | Возвращает устройство обратно |
| forcedreturn | Форсированно возвращает устройство |
| list | Выводит список устройств |
| wholocks | Выводит список процессов, мешающих отключить устройство или вернуть его обратно |
| help <имя_команды> | Выводит справку по команде <имя_команды> |
| help errs | Выводит перечень возвращаемых кодов ошибок (errorlevel) |
| help | Выводит справку по всей командной строке |
Errorlevel возвращаемые командной строкой
0 - операция успешно завершена
1 - Устройство не было найдено
2 - Невозможно остановить устройство. Возникает в случае, когда устройство
заблокировано другой программой, или, когда устройство не предназначено для
остановки
3 - неверный синткасис команды
4 - неизвестная команда
5 - Невозможно найти процессы блокирующие устройство (при остановке устройства) или
его соседей (при возврате устройства). Либо, устройство уже
свободно для извлечения, либо его блокирует какой-то процесс запущенный с более
высокими привилегиями (например, под учетной записью System)
6 - Техническая ошибка во время поиска процессов заблокировавших устройство
7 - Команда не поддерживается данным устройством
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"
|
forcedstop
Форсированно останавливает устройство. Если устройство не может быть остановлено,
программа закрывает все файлы и программы мешающие совершить эту операцию и
пытается остановить его повторно.
Внимание! Эта команда закрывает все файлы открытые с устройства. Поэтому
используйте эту команду только если вы уверены, что нет важных данных для сохранения.
Синтаксис:
usr forcedstop <параметры_команды>
Возможные <параметры_команды>:
| -d DriveLetter | Forcibly stops a device by
its DriveLetter.
You can specify just a drive letter ("C"), a drive letter and ":" ("C:") as well as
a path to a folder or a file on the drive
|
| -n DeviceName | Forcibly stops a device by its name (part
of a name is also acceptable).
"Name" - is those name which is displayed by usr list command
|
Examples:
| "usr forcedstop -d g:" | Stops a device that has drive g: |
| "usr forcedstop -n Sony" | Stops a device with "Sony" word in the name |
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"
|
|
