Ajuda online do DMM Studio › DMM Studio › Estrutura de linguagem › Comandos Apply

Comandos Apply

Os comandos Apply a seguir são usados em scripts do CA DMM.

ApplyDirectory

Aplica o conteúdo de um diretório do computador de origem ao de destino. Este comando usa dois ou três parâmetros. O primeiro parâmetro é o caminho do diretório e um valor de seqüência de caracteres. O segundo parâmetro é uma das constantes de Sobrescrever mostradas a seguir ou o caminho de um novo diretório. Existem três constantes que indicam o método de substituição: ALWAYS, NEWER ou NEVER. Se a constante de Sobrescrever for omitida, será usado o padrão NEWER ou o método Sobrescrever selecionado pelo usuário. Se o segundo parâmetro for o caminho de um novo diretório, o conteúdo do diretório <nome do diretório> será aplicado ao <novo nome de diretório>. É permitido usar um método Sobrescrever opcional. Somente é possível aplicar diretórios que foram armazenados. No processo de movimentação, se o caminho de armazenamento contiver uma seqüência de caracteres curinga, não inclua o caractere curinga no caminho de movimentação.

Primeiro parâmetro:

O nome do diretório (valor de seqüência de caracteres)

Segundo parâmetro:

O nome do novo diretório (valor de seqüência de caracteres)

Terceiro parâmetro:

O método Sobrescrever (valor de seqüência de caracteres)

Uso:

ApplyDirectory(<nome do diretório>, [método de sobrescrever]); ou

ApplyDirectory(<nome do diretório>, <novo nome de diretório>, [método de sobrescrever]);

Exemplo:

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

Aplica um arquivo do computador de origem ao de destino. Este comando usa dois ou três parâmetros. O primeiro parâmetro é o nome do arquivo e um valor de seqüência de caracteres. O segundo parâmetro é uma das constantes de Sobrescrever mostradas a seguir ou o caminho de um novo arquivo. Existem três constantes que indicam o método de substituição: ALWAYS, NEWER ou NEVER. Se a constante de Sobrescrever for omitida, será usado o padrão NEWER ou o método Sobrescrever selecionado pelo usuário. Se o segundo parâmetro for um caminho de um novo arquivo, o arquivo <nome do arquivo> será aplicado a <novo nome de arquivo>. Também é permitido um método Sobrescrever opcional. Este comando reconhece o asterisco (*) como um caractere curinga. Somente é possível aplicar arquivos que foram armazenados. No processo de movimentação, se o caminho de armazenamento contiver uma seqüência de caracteres curinga, não inclua o caractere curinga no caminho de movimentação.

Primeiro parâmetro:

O Nome do arquivo (valor de seqüência de caracteres)

Segundo parâmetro:

O nome do novo arquivo (valor de seqüência de caracteres)

Terceiro parâmetro:

O método Sobrescrever (valor de seqüência de caracteres)

Uso:

ApplyFile(<nome do arquivo>, [método de sobrescrever]); ou

ApplyFile(<nome do arquivo>, <novo nome de arquivo>, [método de sobrescrever]);

Exemplo:

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

ApplyKey

Aplica uma chave do Registro, inclusive todos os respectivos valores, ou uma seção de arquivo .ini com todos os seus valores do computador de origem ao de destino. Este comando pode usar dois parâmetros. Somente é possível aplicar chaves que foram armazenadas.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Segundo parâmetro:

O novo caminho da chave (valor de seqüência de caracteres)

Uso:

ApplyKey(<caminho da chave>, [novo caminho da chave]);

Exemplo:

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

ApplyMappedFile

Aplica um arquivo do computador de origem ao de destino. Se um dos dados do arquivo especificar um caminho de diretório, ele será mapeado no caminho apropriado.

Primeiro parâmetro:

O caminho do arquivo (valor de seqüência de caracteres)

Segundo parâmetro:

O nome do novo arquivo (valor de seqüência de caracteres)

Terceiro parâmetro:

O método Sobrescrever (valor de seqüência de caracteres)

Uso:

ApplyMappedFile(<nome do arquivo>, [método de sobrescrever]); ou

ApplyMappedFile(<nome do arquivo>, <novo nome de arquivo>, [método de sobrescrever]);

Exemplos:

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

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

ApplyMappedKey

Aplica uma chave do Registro e todos os seus valores ou uma seção de arquivo .ini e todos os seus valores da máquina de origem à de destino. Se um dos nomes de valores ou dados de valores for um caminho de diretório, ele será mapeado para o caminho apropriado. Este comando pode usar dois parâmetros. Somente é possível aplicar chaves que foram armazenadas.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Segundo parâmetro:

O novo caminho da chave (valor de seqüência de caracteres)

Uso:

ApplyMappedKey(<caminho da chave>, [novo caminho da chave]);

Exemplo:

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

ApplyMappedSubKeys

Aplica uma chave do Registro, todos os seus valores e todas as suas subchaves ou uma seção de arquivo .ini e todos os seus valores do computador de origem ao de destino. Se um dos nomes de valores ou dados de valores for um caminho de diretório, ele será mapeado para o caminho apropriado. Este comando pode usar dois parâmetros. Somente é possível aplicar chaves que foram armazenadas.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Segundo parâmetro:

O novo caminho da chave (valor de seqüência de caracteres)

Uso:

ApplyMappedSubKeys(<caminho da chave>, [novo caminho da chave]);

Exemplo:

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

ApplyMappedValue

Aplica o valor de uma chave do Registro ou o valor de um arquivo .ini do computador de origem ao de destino. Se o valor ou o nome do valor for um caminho de diretório, ele será mapeado para o caminho apropriado. O comando pode usar seis parâmetros. Somente é possível aplicar como mapeados os valores que foram armazenados como mapeados.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Segundo parâmetro:

O nome do valor (valor de seqüência de caracteres)

Observação: se o valor for o padrão, o segundo parâmetro deverá ser NULL ("")

Terceiro parâmetro:

O novo caminho da chave (valor de seqüência de caracteres)

Observação: se você não mudar o valor para o novo local, o terceiro parâmetro deverá ser NULL ("")

Quarto parâmetro:

O delimitador (valor de seqüência de caracteres)

Quinto parâmetro:

Indicador de Shortpaths (valor booleano)

Sexto parâmetro:

No caso de uma movimentação, o novo nome do Valor (valor de seqüência de caracteres)

Uso:

ApplyMappedValue(<caminho da chave>, <nome do valor>, [novo caminho da chave], [delimitador], [shortpaths], [novo nome do valor]);

Exemplos:

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

Aplica uma chave do Registro, todos os seus valores e todas as suas subchaves do computador de origem ao de destino. Este comando pode usar dois parâmetros. Somente é possível aplicar chaves que foram armazenadas.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Segundo parâmetro:

O novo caminho da chave (valor de seqüência de caracteres)

Uso:

ApplySubKeys(<caminho da chave>, [novo caminho da chave]);

Exemplo:

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

ApplyValue

Aplica um valor de chave do Registro do computador de origem ao de destino. Este comando usa quatro parâmetros. Somente é possível aplicar valores que foram armazenados.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Segundo parâmetro:

O nome do valor (valor de seqüência de caracteres)

Terceiro parâmetro:

O novo caminho da chave (valor de seqüência de caracteres)

Quarto parâmetro:

O novo nome do valor (valor de seqüência de caracteres)

Uso:

ApplyValue(<caminho da chave>, <nome do valor>, [novo caminho da chave], [novo nome do valor]);

Exemplo:

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

DeleteKey

Exclui uma chave e todos os seus valores e subchaves do Registro ou de arquivos .ini. Retorna False se houver problemas ao excluir a chave. Se a chave não existir, retorna True. Se o caminho for de um arquivo .ini, todas as seções do arquivo serão excluídas.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Exemplo:

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

DeleteValue

Exclui um valor do Registro ou de arquivos .ini. Retorna False se houver problemas ao excluir o valor. Se o valor não existir, retornará True.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Segundo parâmetro:

O Nome do valor (valor de seqüência de caracteres)

Exemplo:

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

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

SetKey

Cria ou define uma chave.

Primeiro parâmetro:

O caminho da chave (valor de seqüência de caracteres)

Exemplo:

SetKey("HKLM\\New Key");

SetValue

O comando SetValue cria ou define um valor de chave. Se a chave não existir, esse comando cria a chave.

Esse comando apresenta o seguinte formato:

SetValue(<caminho do arquivo>, <nome do valor>, <dados>, <tipo>)

Caminho do arquivo

(Para registro) representa o caminho da chave (valor da sequência de caracteres).

(Para xml) representa o caminho completo do arquivo.

Nome do valor

(Para registro) representa o nome do valor (sequência de caracteres).

(Para xml) representa a consulta válida do caminho x.

Dados

Representa o valor.

Tipo

Representa o tipo de valor.

Os seguintes valores do registro são aceitos:

Exemplos: definir um valor de chave

• Este exemplo define um valor de chave no caso do registro:

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

• Este exemplo define um valor de chave no caso do XML:

  SetValue("C:\\abc.xml", "/docnode/node1/node2", "É um nó", "");