Создание Скриптов Вручную

Home  Previous  Next

R-Drive Image имеет собственный скриптовый язык, с помощью которого можно создавать скрипты для любого выполняемого действия.

Скрипт состоит из команд и их параметров. Все команды, параметры и их значения чувствительны к регистру.

Несовместимость с версией 3.x

 

Версия 3.x

Версия 4.x

Имена файлов с "

Другое обозначение для символа "

""

"

Имена файлов с &

Другое обозначение для символа &

&

&

Список разделов

Несколько разделов могут находиться в одном списки

-s="part1" -s="part2" -s="part3"

-s="part1 part2 part3"

Общее правило:

Скрипты R-Drive Image имеют расширения по умолчанию .rdi.

Значения параметров могут быть заключены в одинарные (') или двойные (") кавычки. Если значение не содержит пробелов, то кавычки можно не ставить.

R-Drive Image игнорирует пробелы в начале строки. R-Drive Image обрабатывает несколько пробелов как один, за исключением случаев, когда они являются частью значения параметра заключенного в кавычки.

Примеры:

Данные строки обрабатываются одинаково:

create -a = "c:\archive.rdr"

   create   -a = "c:\archive.rdr"

Данные строки не обрабатываются одинаково:

create -a = "c:\archive 1.rdr"

create -a = "c:\archive    1.rdr"

Комментарии:

R-Drive Image обрабатывает как комментарии строки, в которых либо самый первый символ ; , либо самый первый символ [ а самый последний ].

Примеры:

; Это комментарий

[Это комментарий]

Несколько строк:

Если самый последний в строке символ \, то R-Drive Image обрабатывает следующую строку вместе с данной:

Пример:

Строки:

create -a = "c:\archive.rdr" -s = "1:1" \

c = "5"

обрабатываются как строка:

create -a = "c:\archive.rdr" -s="1:1" c=  "5"

Единицы размера диска

Размеры диска могут быть в следующих единицах.

b

байты

 

Kb

килобайты

2^10 = 1,024 b

Mb

мегабайты

2^20 = 1,024 Kb

Gb

гигабайты

2^30 = 1,024 Mb

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

По умолчанию единицей размера диска являются Mb (мегабайты).

Заменяемые символы

Если в значениях параметров присутствуют следующие символы, то они должны быть заменены:

Символ

Замена

"

"

'

'

&

&

carriage return

&cr;

new line

&nl;

Обратите внимание: Это несовместимо со скриптами, созданными для более ранних версий R-Drive Image.

Команды скрипта и параметры:

Команда

Параметры команды

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

Необязательный параметр

Описание и примеры

list

 

Выводит список разделов для логического диска или файла образа

-a=<PathOfNewArchiveFile>

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

Задает путь (с именем файла) к файлу образу.

Например:

-a=C:\Images\Test.rdr or -a="C:\Image Files\Test 1.rdr"

-p=<Password>

Обязательный/Не используется

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

Примеры: -p=Password or -p='My Password'

-t=<TimeSliceNumber>

Необязательный

Задает, какой файл образ, созданный в инкрементальном режиме, будет использоваться для вывода списка разделов. Если параметр TimeSliceNumber не задан, то используются данные в первом файле образе. Параметр -1 задает последний инкрементальный файл образ.

first: R-Drive Image будет использовать первый инкрементальный файл образ.

last: R-Drive Image будет использовать последний инкрементальный файл образ.

+<n>: R-Drive Image будет использовать n-й инкрементальный файл образ с начала.

-<n>: R-Drive Image будет использовать n-й инкрементальный файл образ с конца.

Примеры: -t="+2" при выводе списка разделов будет использоваться второй с начала инкрементальный файл образ.

Пример:

list -a=C:\Images\Test.rdr -p="mY pasSsworRrd"

Данная команда скрипта выводит список разделов в файле образе C:\Images\Test.rdr защищенном паролем mY pasSsworRrd.

sysdump

 

Создает системный дамп, который может быть необходим для получения технической поддержки.  В системный дамп может быть включен файл образ. В этом случае используются параметры -a, -p, -t из команды list.

-sysdump="<SysDumpFile>"

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

Задает имя файла системного дампа.

Пример:

sysdump -sysdump="MySysDump" -a=C:\Images\Test.rdr -p="mY pasSsworRrd"

Данная команда скрипта создает файл с системным дампом с именем MySysDump. Системный дамп включает файл образ C:\Images\Test.rdr защищенный паролем mY pasSsworRrd.

register

 

Регистрирует R-Drive Image из командной строки.

-reg-user="<UserName>"

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

Задает имя пользователя, используемое при регистрации.

-reg-key="<RegistrationKey>"

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

Задает регистрационный ключ, используемый при регистрации.

-reg-company="<UserCompany>"

Необязательный

Задает компанию, используемую при регистрации.

Пример:

register -reg-user="Tester 1" -reg-company=R-TT Testing Team" -reg-key="fafaasertghzfvasfje134"

Данная команда скрипта регистрирует R-Drive Image для пользователя Tester 1 из компании R-TT Testing Team регистрационным ключом fafaasertghzfvasfje134.

Описатели дисковых объектов, используемые в параметрах -s и -d

Ниже приведен список описателей дисковых объектов, которые используются в R-Drive Image для идентификации жестких дисков, логических дисков и разделов. Они записываются в порядке значимости, начиная с самого важного описателя. Если имеются несколько объектов с идентичными описателями, то R-Drive Image идентифицирует их при помощи самого важного описателя с различными значениями.

hdd_vtype

Тип жесткого диска.

real : основной диск

dynamic : динамический диск

pure : дисковые объекты только с одним логическим диском (например, USB флешка).

Пример: hdd_vtype=real

hdd_size

Размер жесткого диска

Размер диска должен быть только в байтах.

Пример: hdd_size=40060403712

hdd_name

Имя жесткого диска

Пример: hdd_name=SAMSUNG&#32;SP0411NTW100-11 (&#32; обозначает пробел)

hdd_serial

Серийный номер жесткого диска

Пример: hdd_serial=S01JJ30X912841

hdd_bus_type

Тип шины жесткого диска

Может быть: none, ata, atapi, scsi, floppy, usb, firewire, ssa, fibre, raid, smart, abios, sata, sata2.

Пример: hdd_bus_type=ata

hdd_port_num

Номер порта жесткого диска

Пример: hdd_port_num=0

hdd_target_id

Target ID жесткого диска

Пример: hdd_target_id=1

hdd_num

Номер диска, совпадает с номером диска в прежних обозначениях.

Пример: hdd_num=1

part_free_space

Свободное место на разделе

1 если объект является свободным местом диска, 0 в остальных случаях.

Пример: part_free_space=1

part_ofs

Смещение раздела в байтах.

Смещение раздела должно быть только в байтах.

Пример: part_ofs=16778264576

part_size

Размер раздела

Размер раздела должен быть только в байтах.

Пример: part_size=23279435776

part_fs

Файловая система раздела

Может быть: none, ntfs, fat12, fat16, fat32, exfat, ext2fs, ext3fs, ext4fs, ufs1, ufs2, hfs ,hfsplus ,hfsx, iso9660

Пример: part_fs=ntfs

part_label

Метка диска

Пример: part_label=Test_Data

part_mounted

Буква диска

Пример: part_mounted=G:\

part_num

Номер раздела, совпадает с номером раздела в прежних обозначениях.

Пример: part_num=2

Раздел может быть идентифицирован при помощи следующих описателей: hdd_size=40060403712+part_num=2+hdd_num=1+hdd_target_id=0+hdd_bus_type=ata+part_label=Part2+part_ofs=16778264576+part_mounted=G:\+hdd_name=SAMSUNG&#32;SP0411NTW100-11+part_size=23279435776+hdd_port_num=0+hdd_serial=S01JJ30X912831+part_fs=ntfs+hdd_vtype=real

create

 

 

append

 

Изменения добавляются дифференциально к существующему файлу образу. Если полный образ диска еще не был создан, то он создастся.

-s=<SourceDisk>

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

Задает исходный объект для создания файла образа или добавления к нему изменений. Параметр <SourceDisk> состоит из одного или нескольких описателей в следующей форме: descriptor_name1=value[+descriptor_name1=value...]. Более подробно об описателях дисковых объектов можно найти в части этой таблицы Описатели дисковых объектов. Также можно использовать и старые обозначения:

Примеры старых обозначений:

для жесткого диска 1: -s=1

для второго раздела жесткого диска 1: -s=1:2

для логического диска: -s=D:

для нескольких логических дисков: -s="D: F:"

-a=<PathOfNewArchiveFile>

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

Задает путь (с именем файла) к файлу образу.

Примеры:

-a=C:\Images\Test.rdr or -a="C:\Image Files\Test 1.rdr"

-c=<CompressionLevel>

Необязательный

Задает уровень сжатия (1...11).

Пример: -c=3

-u

Необязательный

Копировать только реальные данные. Может быть Логический (булев) параметр.

-v=<ArchiveSize>

Необязательный

Задает фиксированный размер образа. Может иметь формат числа с плавающей запятой.

Пример: -v=650 or -v='4.5 Gb'

-append-inc

Необязательный

Задает инкрементальный тип образа.

-p=<Password>

Обязательный/Не используется

Задает пароль образа. Является обязательным параметром для команды append и если файл образ уже был защищен паролем. Если в пароле есть пробел, то пароль должен быть в кавычках.

Примеры: -p=Password или -p='My Password'

-r=<Description of archive>

Необязательный

Задает описание образа. Если в описании есть проблел, то оно должно быть в кавычках.

Примеры: -r=Description или -r="Image Description"

-s-xw

Необязательный

Отключает использование Службы Теневого Копирования Windows.

-s-xr

Необязательный

Отключает использование Службы Теневого Копирования R-TT.

-s-n

Необязательный

Извещает системные приложения об использовании службы теневого копирования.

-s-b0=<AppBeforeBack>

Необязательный

Задает приложение, запускаемое до начала резервного копирования. Приложение должно возвращать код 0.

Пример: -s-b0="C:\commands\start.exe"

-s-b1=<AppAfterBack>

Необязательный

Задает приложение, запускаемое после завершения резервного копирования. Приложение должно возвращать код 0.

Пример: -s-b1="C:\commands\end.exe"

-s-s0=<AppBeforeSnapShot>

Необязательный

Задает приложение, запускаемое до работы службы теневого копирования. Приложение должно возвращать код 0.

Пример: -s-s0="C:\commands\startsnapshot.exe"

-s-s1=<AppAfterSnapShot>

Необязательный

Задает приложение, запускаемое после работы службы теневого копирования. Приложение должно возвращать код 0.

Пример: -s-s1="C:\commands\endsnapshot.exe"

-xe=<AppIfError>

Необязательный

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

Примеры: -xe=error.exe или -xe="winamp C:\sounds\error.mp3"

-xs=<AppIfSucc>

Необязательный

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

Примеры: -xs=success.exe или -xs="winamp C:\sounds\success.mp3"

-bs

Необязательный

Задает использование резервных комплектов.

-bs-size="<Quota_in_MB>"

Необязательный

Может использоваться только если установлен параметр -bs. Задает максимально возможный размер резервного комплекта на диске в МБ. При превышении данного размера резервный комплект (все его файлы) удаляется.

Example: -bs-size="20000"

-bs-num-b="<Number_of_backs>"

Необязательный

Может использоваться только если установлен параметр -bs. Задает максимальное число резервных комплектов. Если данное число превышено, то старые резервные комплекты (все их файлы) удаляются.

Пример: -bs-num-b="10"

-bs-num-f="<Number_of_files>"

Необязательный

Может использоваться только если установлен параметр -bs. Задает максимальное число файлов образов во всех резервных комплектах. Если данное число превышено, то старые резервные комплекты (все их файлы) удаляются.

Пример: -bs-num-f="30"

-bs-age="<Days>"

Необязательный

Может использоваться только если установлен параметр -bs. Задает максимальное число дней хранения резервного комплекта. По прошествии данного числа дней резервный комплект удаляется.

Пример: -bs-age="14"

-cd-cache

Необязательный

Используется когда файл образ записывается на CD диски. R-Drive Image создает ISO образ CD диска и потом записывает его на CD диск. Без этого параметра R-Drive Image записывает данные напрямую на CD диск.

-cd-speed=<Speed>

Необязательный

Используется когда файл образ записывается на CD диски. Задает скорость записи в КБ/с.

Пример: -cd-speed="1200"

-dvd-cache

Необязательный

Используется когда файл образ записывается на DVD диски. R-Drive Image создает ISO образ DVD диска и потом записывает его на DVD диск. Без этого параметра R-Drive Image записывает данные напрямую на DVD диск.

-dvd-speed

Необязательный

Используется когда файл образ записывается на DVD диски. Задает скорость записи в КБ/с.

Пример: -dvd-speed="3324"

Пример:

create -s="hdd_size=40060403712+part_num=1+hdd_num=2+hdd_target_id=0+hdd_bus_type=ata+part_label=Part1+part_ofs=1048576+part_mounted=F:\+hdd_name=SAMSUNG&#32;SP0411NTW100-11+part_size=16777216000+hdd_port_num=0+hdd_serial=S01JJ30X912831+part_fs=ntfs+hdd_vtype=real,hdd_size=40060403712+part_num=2+hdd_num=2+hdd_target_id=0+hdd_bus_type=ata+part_label=Part2+part_ofs=16778264576+part_mounted=H:\+hdd_name=SAMSUNG&#32;SP0411NTW100-11+part_size=23279435776+hdd_port_num=0+hdd_serial=S01JJ30X912831+part_fs=ntfs+hdd_vtype=real" -a="I:\Test Image.rdr" -c=3 -u = true -p="My Password" -r="This is a test image" -xe="winamp C:\sounds\error.mp3" -xs="winamp C:\sounds\success.mp3"

Данная команда скрипта создает образ логических дисков F: и H: на жестком диске Samsung. Путь и имя файла данного образа I:\Test Image.rdr, уровень сжатия 3, в образ записываются только реальные данные на диске. Данный образ защищен паролем "My Password" и имеет описание "This is a test image". Если действие выполяется успешно, то утилита winamp проигрывает файл success.mp3, если действие не выполняется - то error.mp3.

restore

 

Восстанавливает данные из образа на заданное место диска

copy

 

Копирует диск на диск.

-s=<SourceDisk>

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

Задает исходный объект (источник). Параметр <SourceDisk> состоит из одного или нескольких описателей в следующей форме: descriptor_name1=value[+descriptor_name1=value...]. Более подробно об описателях дисковых объектов можно найти в части этой таблицы Описатели дисковых объектов. Также можно использовать и старые обозначения:

Примеры старых обозначений:

для жесткого диска 1: -s=1

для второго раздела жесткого диска 1: -s=1:2

для логического диска: -s=D:

-d=<DestinationDisk>

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

Задает конечный диск:раздел, на который восстанавливаются (копируются) данные (приемник). Параметр <DestinationDisk> состоит из одного или нескольких описателей в следующей форме: descriptor_name1=value[+descriptor_name1=value...]. Более подробно об описателях дисковых объектов можно найти в части этой таблицы Описатели дисковых объектов. Также можно использовать и старые обозначения:

Примеры старых обозначений:

для жесткого диска 1: -d=1

для второго раздела жесткого диска 1: -d=1:2

для логического диска: -d=D:

-a=<PathOfArchiveFile>

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

Используется только в команде restore.

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

Примеры: -a=C:\Images\Test.rdr или -a="C:\Image Files\Test.rdr"

-k=<"PartitionStatus">

Необязательный

Задает тип восстанавливаемого (копируемого) раздела (основной/активный).

Может иметь значения:

+p это основной раздел -p это дополнительный раздел

+a это активный раздел -a это неактивный раздел

Обратите внимание, что комбинация "-p +a" недопустима. Если данный параметр не задан, то используются данные из образа.

Примеры:

-k="+p+a" раздел будет основным и активным.

-k="+p" раздел будет основным. Будет раздел активным или не активным зависит от информации в образе.

-t=<TimeSliceNumber>

Необязательный

Используется только в команде restore.

Задает, какой файл образ, созданный в инкрементальном режиме, будет использоваться для восстановления данных из образа. Если параметр TimeSliceNumber не задан, то используются данные в первом файле образе. Параметр -1 задает последний инкрементальный файл образ.

first: R-Drive Image будет использовать первый инкрементальный файл образ.

last: R-Drive Image будет использовать последний инкрементальный файл образ.

+<n>: R-Drive Image  будет использовать n-й инкрементальный файл образ с начала.

-<n>: R-Drive Image будет использовать n-й инкрементальный файл образ с конца.

Примеры: -t="+2" при выводе списка разделов будет использоваться второй с начала инкрементальный файл образ.

-lr=<DiskLetter>

Необязательный

Задает букву диска. Данный параметр нечувствительный к регистру.

Примеры: -lr="K" или -lr=K.

-sz=<PartitionSize>

Необязательный

Задает размер раздела. Может иметь формат числа с плавающей запятой.

Пример: -sz=512 или -sz='0.5 Gb'

-of=<PartitionOfset>

Необязательный

Задает смещение до начала восстанавливаемого раздела. Может иметь формат числа с плавающей запятой. По умолчанию 0.

Пример: -of=512 или -of='0.5 Gb'

-bs-use="<Parameter>"

Необязательный

Используется только в команде restore.

Задает, какой резервный комплект будет использоваться для восстановления данных из образа. Может принимать следующие значения:

first: R-Drive Image будет использовать первый резервный комплект.

last: R-Drive Image будет использовать последний резервный комплект.

+<n>: R-Drive Image будет использовать n-й резервный комплект с начала.

-<n>: R-Drive Image будет использовать n-й резервный комплект с конца.

<date>: R-Drive Image будет использовать резервный комплект, в имени которого имеется значение date.

Примеры:

-bs-use="+3": R-Drive Image будет использовать третий резервный комплект с начала.

-bs-use="20080521": R-Drive Image будет использовать резервный комплект, в имени которого имеется значение " 20080521".

-p=<password>

Обязательный /Не используется

Используется только в команде restore.

Является обязательным параметров для файлов образов защищенных паролем. Задает пароль файла образа.

Пример: -p="my password"

-hdd-mode="<ModeType>"

Необязательный

Используется только при копировании/восстановлении жестких дисков.

Задает параметры восстановления/копирования (метод восстановления) жестких дисков. Может принимать следующие значения:

0: Метод по умолчанию

1: Сырое копирование диска

2: Копирование всех разделов без изменения

19: Выравнивание разделов

20: Выравнивание разделов (Не изменять активный раздел)

51: Сжать/Расширить раздел на весь диск

52: Сжать/Расширить раздел на весь диск (Не изменять активный раздел)

Пример:

restore -a="I:\Test Image.rdr" -s="hdd_size=40060403712+part_num=1+hdd_num=1+hdd_target_id=0+hdd_bus_type=ata+part_label=Part2+part_ofs=16778264576+part_mounted=G:\+hdd_name=SAMSUNG&#32;SP0411NTW100-11+part_size=23279435776+hdd_port_num=0+hdd_serial=S01JJ30X912831+part_fs=ntfs+hdd_vtype=real" -d="hdd_size=40060403712+part_num=2+hdd_num=1+hdd_target_id=0+hdd_bus_type=ata+part_label=Part2+part_ofs=16778264576+part_mounted=G:\+hdd_name=SAMSUNG&#32;SP0411NTW100-11+part_size=23279435776+hdd_port_num=0+hdd_serial=S01JJ30X912831+part_fs=ntfs+hdd_vtype=real" -p="My Password" -xe="winamp C:\sounds\error.mp3" -xs="winamp C:\sounds\success.mp3"

Данная команда скрипта восстанавливает данные на логический диск G: на жестком диске Samsung HDD, исходный файл образ "I:\Test Image.rdr", для восстановления используются данные из первого раздела образа. Образ защищен паролем "My Password". Если действие выполяется успешно, то утилита winamp проигрывает файл success.mp3, если действие не выполняется - то error.mp3.

restorefiles

 

Восстанавливает отдельные файлы из образа в заданное место

-s="<SourceDisk>"

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

Задает исходный объект (источник). Параметр <SourceDisk> состоит из одного или нескольких описателей в следующей форме: descriptor_name1=value[+descriptor_name1=value...]. Более подробно об описателях дисковых объектов можно найти в части этой таблицы Описатели дисковых объектов. Также можно использовать и старые обозначения:

Примеры старых обозначений:

для жесткого диска 1: -s=1

для второго раздела жесткого диска 1: -s=1:2

для логического диска: -s=D:

-a="<PathOfArchiveFile>"

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

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

Примеры: -a=C:\Images\Test.rdr or -a="C:\Image Files\Test.rdr"

-filelist="<ListOfFilesToRestore>"

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

Задает список восстанавливаемых файлов из образа.

Пример: -filelist="MyPhoto/*,Photo/Picture 001.jpg,Photo/Picture 003.jpg"

-outdir="<OutputFolder>"

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

Задает папку, в которую восстанавливаются файлы.

Пример: -outdir="D:\1111"

Пример:

restorefiles -s="hdd_size=7509196800+part_num=1+hdd_num=1+hdd_target_id=0+hdd_bus_type=ata+part_label=NTFS-Test+part_ofs=64512+part_mounted=F:\+hdd_name=WDC&#32;WD75DA-00AWA107.21L07+part_size=3141991936+hdd_port_num=0+hdd_serial=WD-WMA1J1262876+part_fs=ntfs+hdd_vtype=real" -a="I:\Test_Image.rdr" -t="+1" -filelist="MyPhoto/*,Photo/Picture 001.jpg,Photo/Picture 003.jpg,Photo/Picture 005.jpg,Photo/Picture 007.jpg,Photo/Picture 009.jpg,Photo/Picture 010.jpg,Photo/Picture 011.jpg,Photo/Picture 013.jpg,Photo/Picture 015.jpg,Photo/Picture 016.jpg,Photo/Picture 017.jpg,Photo/Picture 018.jpg,Photo/Picture 019.jpg,Photo/Picture 020.jpg,Photo/Picture 021.jpg,Photo/Picture 022.jpg,Photo/Picture 023.jpg,Photo/Picture 024.jpg,Photo/Picture 025.jpg,Photo/Picture 026.jpg,Photo/Picture 027.jpg,Photo/Picture 028.jpg" -outdir="D:\1111"

Данная команда скрипта восстанавливает заданные файлы в папку D:\1111 из образа первого раздела жесткого диска, сохраненного в файле I:\Test_Image.rdr.

check

 

Проверяет файл образ на предмет корректности его создания

-a=<PathOfArchiveFile>

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

Задает путь (с именем файла) к файлу образу, который проверяется на предмет корректности создания.  Если в пути есть пробел, то он должен быть в кавычках.

Примеры: -a=C:\Images\Test.rdr or -a="C:\Image Files\Test.rdr"

Пример:

check -a="I:\Test Image.rdr"

Данная команда скрипта проверяет файл образ I:\Test Image.rdr на предмет корректности его создания.

mount

 

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

-a=<PathOfNewArchiveFile>

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

Задает путь (с именем файла) к файлу образу.

Примеры:

-a=C:\Images\Test.rdr или -a="C:\Image Files\Test 1.rdr"

-s=<SourceDisk>

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

Задает подключаемый объект в образе. Параметр <SourceDisk> состоит из одного или нескольких описателей в следующей форме: descriptor_name1=value[+descriptor_name1=value...]. Более подробно об описателях дисковых объектов можно найти в части этой таблицы Описатели дисковых объектов. Также можно использовать и старые обозначения:

Примеры старых обозначений:

для второго раздела жесткого диска 1: -s=1:2

для логического диска: -s=D:

-lr=<DiskLetter>

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

Задает букву диска. Данный параметр нечувствителен к регистру.

Примеры: -lr="K" or -lr=K.

-t=<TimeSliceNumber>

Необязательный

Задает, какой файл образ, созданный в инкрементальном режиме, будет использоваться для подключения образа. Если параметр TimeSliceNumber не задан, то используются данные в первом файле образе. Параметр -1 задает последний инкрементальный файл образ.

first: R-Drive Image будет использовать первый инкрементальный файл образ.

last: R-Drive Image будет использовать последний инкрементальный файл образ.

+<n>: R-Drive Image будет использовать n-й инкрементальный файл образ с начала.

-<n>: R-Drive Image будет использовать n-й инкрементальный файл образ с конца.

Примеры: -t="+2" при подключении образа будет использоваться второй с начала инкрементальный файл образ.

-bs-use="<Parameter>"

Необязательный

Задает, какой резервный комплект будет использоваться для подключения образа. Может принимать следующие значения:

first: R-Drive Image будет использовать первый резервный комплект.

last: R-Drive Image будет использовать последний резервный комплект.

+<n>: R-Drive Image будет использовать n-й резервный комплект с начала.

-<n>: R-Drive Image будет использовать n-й резервный комплект с конца.

<date>: R-Drive Image будет использовать резервный комплект, в имени которого имеется значение date.

Примеры:

-bs-use="+3": R-Drive Image будет использовать третий резервный комплект с начала.

-bs-use="20080521": R-Drive Image будет использовать резервный комплект, в имени которого имеется значение " 20080521".

Пример:

mount -a="I:\Test Image.rdr" -s=1:2 lr=F: -t=-1

Данная команда скрипта подключает второй раздел первого жесткого диска, содержащегося в файле образе I:\Test Image.rdr, как виртуальный логический диск с буквой F:.

unmount

 

Отключает подключенный виртуальный диск.

-lr=<DiskLetter>

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

Задает букву диска. Данный параметр нечувствителен к регистру.

Примеры: -lr="K" или -lr=K.

Пример:

unmount lr=F:

Данная команда скрипта отключает виртуальный логический диск F:.

activate

 

Делает заданный раздел активным.

Должен быть задан необходимый раздел

-s=<SourceDisk>

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

Задает раздел на диске, который будет сделан активным. Параметр <SourceDisk> состоит из одного или нескольких описателей в следующей форме: descriptor_name1=value[+descriptor_name1=value...]. Более подробно об описателях дисковых объектов можно найти в части этой таблицы Описатели дисковых объектов. Также можно использовать и старые обозначения:

Примеры старых обозначений:

для второго раздела жесткого диска 1: -s=1:2

для логического диска: -s=D:

Пример:

activate -s=1:1

Данная команда скрипта делает первый раздел первого жесткого диска активным.

delete

 

Удаляет раздел на диске

Должен быть задан необходимый раздел

-s=<SourceDisk>

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

Задает удаляемый раздел на диске. Параметр <SourceDisk> состоит из одного или нескольких описателей в следующей форме: descriptor_name1=value[+descriptor_name1=value...]. Более подробно об описателях дисковых объектов можно найти в части этой таблицы Описатели дисковых объектов. Также можно использовать и старые обозначения:

Примеры старых обозначений:

для второго раздела жесткого диска 1: -s=1:2

для логического диска: -s=D:

Пример:

delete -s=F:

Данная команда скрипта удаляет логический диск F:.

clear

 

Удаляет все разделы на диске

-s=<SourceDisk>

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

Задает жесткий диск, все разделы которого должны быть удалены. Параметр <SourceDisk> состоит из одного или нескольких описателей в следующей форме: descriptor_name1=value[+descriptor_name1=value...]. Более подробно об описателях дисковых объектов можно найти в части этой таблицы Описатели дисковых объектов. Также можно использовать и старые обозначения:

Примеры старых обозначений:

для жесткого диска 1: -s=1

-part-type=<PartitionType>

Необязательный/Обязательный

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

<PartitionType> может быть:

mbr: R-Drive Image создаст тип таблицы разделов MBR.

gpt: R-Drive Image создаст тип таблицы разделов GPT.

Если данного параметра нет, то существующая таблица разделов будет очищаться. Обязателен, если таблицы разделов на диске еще нет.

Пример:

clear -s=2

Данная команда скрипта удаляет все разделы на втором жестком диске.

fixmbr

 

Инсталлирует загрузчик по умолчанию на жесткий диск

-s=<SourceDisk>

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

Задает жесткий диск, ка котором будет инсталлирован загрузчик. Пример:

для жесткого диска 1: -s=1

Пример:

fixmbr -s=1

Данная команда скрипта инсталлирует загрузчик по умолчанию на первый жесткий диск.

mail

Необязательный

Задает все параметры e-mail уведомления

Пример:

mail -ms=mail.example.com -ma=rtt1@example.com -mr=rtt2@example.com -ml=rtt1:password -me -mx

Данная команда скрипта посылает e-mail уведомления, подтверждающие успешное или неуспешное выполнение действия с адреса rtt1@example.com на адрес rtt2@example.com через SMTP сервер mail.example.com с использованием порта по умолчанию (25) , имени пользователя rtt1 и пароля password.

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

Данные параметры могут использоваться во всех командах



-log="<LogOptions>"

Необязательный

Задает, как R-Drive Image проторолирует действия в режиме командной строки. По умолчанию протокол (лог) R-Drive Image записывается в Журнал событий WinNT при запуске из планировщика задач Windows, однако возможно также создание собственного файла протокола (журнала) с расширением xml.

LogOptions может иметь следующие значения:

#nodefault: отключается протоколирование по умолчанию в syslog

<filename>: файл протокола (журнала) записывается в заданный файл в заданной папке. Пример: c:\mylogs\mylog.txt. Символ "," в имени файла должен стоять два раза.

<filepath>: файлы протокола (журнала) (отдельные для каждой сессии) записываются в заданную папку. Каждый файл будет иметь следующее имя: date_time.rdl. Примеры: c:\mydir\, имя файла: 20081003_215302.rdl.

#syslog: протоколы (логи) записываются в журнал событий WinNT.

#sysdir: протоколы (логи) записываются в C:\Documents and Settings\All Users\Application Data\R-TT\R-Drive Image\Logs\.

Пример: -log="#nodefault,c:\mylog.txt,c:\mydir\,#sysdir"

R-Drive Image записывает протокол (лог) в файл c:\mylog.txt, также в папки c:\mydir\ и C:\Documents and Settings\All Users\Application Data\R-TT\R-Drive Image\Logs\ и не записывает протокол (лог) в Журнал событий WinNT.

mail options

Необязательный

Посылает e-mail уведомления при успешном или неуспешном выполнении действия и задает параметры e-mail. Если на вашем компьютере инсталлирован персональный брандмауэр (firewall), то надо открыть приложению r-driveimagecl.exe доступ к почтовому серверу.

-me

Необязательный

Посылает e-mail уведомление если заданное действие не выполнено. Может быть Логический (булев) параметр.

-mx

Необязательный

Посылает e-mail уведомление если заданное действие выполнено успешно. Может быть Логический (булев) параметр.

-ms=<SMTPServer[:port]>

Обязательный/Не используется

Обязательный параметр при использовании параметра -me или/и -mx. Задает SMTP сервер и порт (не обязательно).

Примеры: -ms=mail.example.com or -ms=mail.example.com:25

-ma=<SenderEmail>

Обязательный/Не используется

Обязательный параметр при использовании параметра -me или/и -mx. Задает e-mail отправителя.

Пример: -ma=rtt1@example.com

-mr=<RecepientEmail>

Обязательный/Не используется

Обязательный параметр при использовании параметра -me или/и -mx. Задает e-mail получателя (получателей).

Пример: -ma=rtt2@example.com

-ml=<Login:Password>

Необязательный

Задает имя пользователя и пароль SMTP сервера.

Пример: -ml=rtt1:password

Логические (булевы) параметры

Параметры могут принимать Логические (булевы) значения:

true, 1, yes, false, 0, no.

Здесь параметры можно использовать как ключи (пример: -u) или как параметры с логическими (булевыми) значениями (пример: -u=true).

Элементы или Переменные R-Drive Image.

Переменные R-Drive Image могут использоваться для создания текстовых строк. Они начинаются с символа & и заканчиваются символом ;.

Переменные номера версии R-Drive Image.

В приведенных ниже примерах предполагается, что используется версия R-Drive Image 4.1.67

Переменная

Описание

&rdi.ver;

Версия R-Drive Image. Пример: "4.1"

&rdi.ver.build;

Сборка R-Drive Image. Пример: "4167"

&rdi.ver.major;

Основная версия R-Drive Image. Пример: "4"

&rdi.ver.minor;

Дополнительный номер версии R-Drive Image. Пример: "1"

&rdi.ver.subminor;

Подверсия R-Drive Image. Пример: "67"

Переменные результата выполнения операции

Переменная

Описание

&rdi.last_result;

Возвращает последний результат выполненной R-Drive Image операции. Может быть undefined, success, failed.

Переменные времени.

В приведенных ниже примерах предполагается, что системное время 11:10:04 AM

Переменная

Описание

&sys.time;

Системное время в локальном формате. Пример: "11:10:04". Обратите внимание, что эту переменную нельзя использовать в имени файла, так как она содержит невалидный символ :.

&sys.time.m;

Минуты

&sys.time.h;

Часы в формате 24 h

&sys.time.h12;

Часы в формате 12 h

&sys.time.h24;

Часы в формате 24 h

&sys.time.s;

Секунды

&sys.time._m;

PM или AM

Переменные даты.

В приведенных ниже примерах предполагается, что системная дата 1  февраля 2007 года, четверг

Переменная

Описание

&sys.date;

Системная дата в локальном формате. Пример: "29/01/07". Обратите внимание, что использовать данную переменную в имени файла не рекомендуется, так как при этом будет создано несколько папок.

&sys.date.d;

День месяца. Пример: "01"

&sys.date.m;

Месяц. Пример: "02"

&sys.date.y;

Год (кратко). Пример: "07"

&sys.date.yyyy;

Год (полностью). Пример: "2007"

&sys.date.m.name;

Название месяца. Пример: "February"

&sys.date.m.nm;

Название месяца (кратко). Пример: "Feb"

&sys.date.wd;

Номер дня недели начиная с Воскресенья. Пример: "5"

&sys.date.wd.name;

Название дня недели. Пример: "Thursday"

&sys.date.wd.nm;

Название дня недели (кратко). Пример: "Th"

Переменные числа обращений

Переменная

Описание

&rdi.enum;

Определяет число обращений к данной переменной. Начинается с 0.

&rdi.enum.<Num>;

Определяет число обращений к данной переменной. Начинается с 0. Num задает формат числа. Пример: &rdi.enum.3; возвращает значение 001 при втором обращении к данной переменной.

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

Пользователь может создавать собственные переменные. Для этого используется команда set. Пример:

set creat_date = "&sys.date.m.name;-&sys.date.d;-&sys.date.y;"

Например, данную переменную можно использовать для создания файла образа с именем, соответствующем дате его создания:

create -a="D:\archive\&creat_date;.rdr" -s="c:"

Если дата, когда был запущен скрипт, 1 февраля 2007 года, то данная команда будет создавать образ логического диска C: и сохранять его в файле D:\archive\February-01-07.rdr.

Обратите внимание, что команда set определяет именно переменные, а не их значения. Значение переменной определяется каждый раз при ее использовании. Пример:

set creat_time = "&sys.time.h24;-&sys.time.m;-&sys.time.s;"

и creat_time используется в двух командах в скрипте:

create -a="D:\archive\&creat_time;.rdr" -s="c:"

create -a="D:\archive\&creat_time;.rdr" -s="c:"

R-Drive Image создаст два разных файла с разными именами, соответствующими времени создания файла.

При помощи команды unset можно удалить переменные. Пример:

unset creat_date creat_time

После выполнения данной команды переменные creat_date и creat_time использоваться не будут, и при выполнении скрипта с данными переменными будет возникать ошибка.

 

В разделе Действия с Диском описываются основные действия с диском.

В разделе Загрузочная Версия описывается выполнение действий с диском в Загрузочной Версии R-Drive Image.

В разделе Техническая Информация находится информация о Поддерживаемых Устройствах Записи CD/DVD, Список Поддерживаемых Устройств в Загрузочной Весрии и приводится некоторая другая полезная информация.

По следующей ссылке можно найти Контактную Информацию и Информацию о Технической Поддержке продукта R-Drive Image