Apply 命令

DMM Studio 联机帮助 › DMM Studio › 语言结构 › Apply 命令

Apply 命令

以下是 CA DMM 脚本中使用的 Apply 命令。

ApplyDirectory

将目录内容从源计算机应用到目标计算机。此命令带有两三个参数。第一个参数是目录路径，为字符串值。第二个参数是以下覆盖常量之一，或新目录路径。覆盖方法由三个常量来表示：ALWAYS、NEWER 或 NEVER。如果忽略覆盖常量，则应用默认值 NEWER 或用户选定的覆盖方法。如果第二个参数是一个新的目录路径，则将目录 <目录名> 的内容应用于 <新目录名称>。允许可选覆盖方法。只有已存储的目录才可应用。移动时，如果存储路径包含通配符字符串，则在移动路径中不能包括通配符。

第一个参数：

目录名（字符串值）

第二个参数：

新目录名（字符串值）

第三个参数：

覆盖方法（字符串值）

用法:

ApplyDirectory(<目录名>, [覆盖方法]); 或

ApplyDirectory(<目录名>, <新文件夹名>, [覆盖方法]);

示例：

ApplyDirectory("c:\\My Documents");
ApplyDirectory("c:\\My Documents", NEWER);
ApplyDirectory("c:\\My Documents", "c:\\Word Documents");
ApplyDirectory("c:\\My Documents", "c:\\Word Documents", ALWAYS);
/*Wildcard example*/
ApplyDirectory("c:\\My Documents\\*.fol", "c:\\New Path\\Word Documents", ALWAYS);

ApplyFile

将文件从源计算机应用到目标计算机。此命令带有两三个参数。第一个参数为文件名，是一个字符串值。第二个参数是以下覆盖常量之一，或新文件路径。覆盖方法由三个常量来表示：ALWAYS、NEWER 或 NEVER。如果忽略覆盖常量，则应用默认值 NEWER 或用户选定的覆盖方法。如果第二个参数为新文件路径，则将文件 <文件名> 应用于 <新文件名>。也允许可选覆盖方法。此命令识别星号 (*) 作为通配符。只有已存储的文件才可应用。移动时，如果存储路径包含通配符字符串，则在移动路径中不能包括通配符。

第一个参数：

文件名（字符串值）

第二个参数：

新文件名（字符串值）

第三个参数：

覆盖方法（字符串值）

用法:

ApplyFile(<文件名>, [覆盖方法]); 或

ApplyFile(<文件名>, <新文件名>, [覆盖方法]);

示例：

ApplyFile("c:\\temp\\file.txt");
/*Wildcard example*/
ApplyFile("c:\\My Documents\\*.txt", "c:\\New Path\\Word Documents", ALWAYS);

ApplyKey

将注册表项及其所有值或 ini 文件节及其所有值从源计算机应用到目标计算机。此命令可带两个参数。只有已存储的注册表项才可应用。

第一个参数：

注册表项路径（字符串值）

第二个参数：

新注册表项路径（字符串值）

用法:

ApplyKey(<注册表项路径>, [新注册表项路径]);

示例

ApplyKey("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedFile

将文件从源计算机应用到目标计算机。如果任意文件数据指定了目录路径，则会映射到相应路径。

第一个参数：

文件路径（字符串值）

第二个参数：

新文件名（字符串值）

第三个参数：

覆盖方法（字符串值）

用法:

ApplyMappedFile(<File name>, [overwrite method]); 或

ApplyMappedFile(<File name>, <new File name>, [overwrite method]);

示例:

ApplyMappedFile("c:\\temp\\file.txt");

ApplyMappedFile("c:\\My Documents\\file.txt", "c:\\New Path\\Word Documents\\file.txt", ALWAYS);

ApplyMappedKey

将注册表项及其所有值或 ini 文件节及其所有值从源计算机应用到目标计算机。如果有任何值名称或值数据是目录路径，将把它们映射到相应的路径。此命令可带两个参数。只有已存储的注册表项才可应用。

第一个参数：: 注册表项路径（字符串值）
第二个参数：

新注册表项路径（字符串值）

用法:

ApplyMappedKey(<注册表项路径>, [新注册表项路径]);

示例：

ApplyMappedKey("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedSubKeys

将注册表项及其所有值和所有子项或者 ini 文件节及其所有值从源计算机应用到目标计算机。如果有任何值名称或值数据是目录路径，将把它们映射到相应的路径。此命令可带两个参数。只有已存储的注册表项才可应用。

第一个参数：

注册表项路径（字符串值）

第二个参数：

新注册表项路径（字符串值）

用法:

ApplyMappedSubKeys(<注册表项路径>, [新注册表项路径]);

示例：

ApplyMappedSubKeys("HKLM\\Software\\Microsoft\\Office\\8.0\\Word\\Data\\Toolbar");

ApplyMappedValue

将注册表项值或 .ini 文件值从源计算机应用到目标计算机。如果值名称或值是目录路径，将被映射到相应的路径。此命令可带六个参数。只有在文件模式设置为“映射”时存储的值才能在文件模式设置为“映射”时应用。

第一个参数：: 注册表项路径（字符串值）
第二个参数：: 值名称（字符串值）

注意：如果该值为默认值，则第二个参数应为“空”("")

第三个参数：: 新注册表项路径（字符串值）

注意：如果未将值移至新位置，则第三个参数应为“空”("")

第四个参数：

分隔符（字符串值）

第五个参数：

快捷路径指示符（布尔值）

第六个参数：

如果发生移动，则为新值名称（字符串值）

用法:

ApplyMappedValue(<注册表项路径>, <值名称>, [新注册表项路径], [分隔符], [快捷路径], [新值名称]);

示例:

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips","HKLM\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", "HKLM\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", ";");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", "", ";");

ApplyMappedValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\", "Tooltips", "", ";", true);

ApplySubKeys

将注册表项及其所有值和所有子项从源计算机应用到目标计算机。此命令可带两个参数。只有已存储的注册表项才可应用。

第一个参数：

注册表项路径（字符串值）

第二个参数：

新注册表项路径（字符串值）

用法:

ApplySubKeys(<注册表项路径>, [新注册表项路径]);

示例：

ApplySubKeys("HKCU\\Software\\Microsoft\\Office\\8.0\\Word");

ApplyValue

将注册表项值从源计算机应用到目标计算机。此命令有四个参数。只有已存储的值才可应用。

第一个参数：

注册表项路径（字符串值）

第二个参数：

值名称（字符串值）

第三个参数：

新注册表项路径（字符串值）

第四个参数：

新值名称（字符串值）

用法:

ApplyValue(<注册表项路径>, <值名称>, [新注册表项路径], [新值名称]);

示例：

ApplyValue("HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips");

DeleteKey

从注册表或 ini 文件中删除注册表项所有的值和注册表子项。如果在注册表项时出现问题，则返回“假”。如果注册表项不存在，则返回“真”。如果将路径用于 ini 文件中，则 ini 文件周围各部分均被删除。

第一个参数：

注册表项路径（字符串值）

示例：

DeleteKey( "HKCU\\Software\\MyApp");
DeleteKey( "c:\\windows\\test.ini\\Keyname");
/* all keys deleted */
DeleteKey( "c:\\windows\\test.ini");

DeleteValue

从注册表或 ini 文件删除值。如果在删除值时出现问题，则返回假。如果值不存在，则返回真。

第一个参数：: 注册表项路径（字符串值）
第二个参数：

值名称（字符串值）

示例：

DeleteValue( "HKCU\\Software\\MyApp", "SomeValue");

DeleteValue( "c:\\windows\\win.ini\", "SomeValue");

SetKey

创建或设置注册表项。

第一个参数：

注册表项路径（字符串值）

示例：

SetKey("HKLM\\New Key");

SetValue

SetValue 命令将创建或设置一个密钥值。如果该密钥不存在，则此命令将创建它。

此命令具有以下格式：

SetValue(<FilePath>, <ValueName>, <Data>, <Type>)

Filepath

（对于注册表）代表密钥路径（字符串值）。

（对于 XML）代表完整的文件路径。

ValueName

（对于注册表）代表值名称（字符串值）。

（对于 XML）代表有效的 XPath 查询。

数据

代表值。

类型

代表值类型。

以下是接受的注册表值：

值	格式	示例
STRING	字符串	"Brian"
DWORD	number	"1999"
BINARY	二进制	"af 45 99 31"
DWORD_LITTLE_ENDIAN	number	"1234"
DWORD_BIG_ENDIAN	number	"1234"
SYMBOLIC_LINK	二进制	"af 45 99 31"
MULTI_STRING	二进制	"af 45 99 31"
RESOURCE_LIST	二进制	"af 45 99 31"
EXPAND_STRING	字符串	"Brian"
FULL_RESOURCE_DESCRIPTOR	二进制	"af 45 99 31"
RESOURCE_REQUIREMENTS_LIST	二进制	"af 45 99 31"

示例：设置密钥值

此示例假设在注册表中设置密钥值：

SetValue("HKLM\\Destination", "String Value", "This is a string value", STRING);

此示例假设在 XML 文件中设置密钥值：

SetValue("C:\\abc.xml", "/docnode/node1/node2", "It is a node", "");