적용 명령

DMM 스튜디오 온라인 도움말 › DMM 스튜디오 › 언어 구조 › 적용 명령

적용 명령

다음은 CA DMM 스크립트에서 사용되는 적용 명령입니다.

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 파일 섹션과 모든 ini 파일 섹션 값을 원본에서 대상 컴퓨터로 적용합니다. 이 명령은 두 개의 매개 변수를 사용할 수 있습니다. 이미 저장된 키만 적용할 수 있습니다.

첫 번째 매개 변수:

키 경로(문자열 값)

두 번째 매개 변수:

새 키 경로(문자열 값)

사용법:

ApplyKey(<키 경로>, [새 키 경로]);

예제

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

ApplyMappedFile

원본에서 대상 컴퓨터로 파일을 적용합니다. 파일의 데이터가 디렉터리 경로를 지정하는 경우 적절한 경로로 매핑됩니다.

첫 번째 매개 변수:

파일 경로(문자열 값)

두 번째 매개 변수:

새 파일 이름(문자열 값)

세 번째 매개 변수:

덮어쓰기 방법(문자열 값)

사용법:

ApplyMappedFile(<파일 이름>, [덮어쓰기 방법]); 또는

ApplyMappedFile(<파일 이름>, <새 파일 이름>, [덮어쓰기 방법]);

예제:

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

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

ApplyMappedKey

레지스트리 키와 모든 레지스트리 키 값 또는 ini 파일 섹션과 모든 ini 파일 섹션 값을 원본에서 대상 컴퓨터로 적용합니다. 일부 값 이름 또는 값 데이터가 디렉터리 경로인 경우 적절한 경로로 매핑됩니다. 이 명령은 두 개의 매개 변수를 사용할 수 있습니다. 이미 저장된 키만 적용할 수 있습니다.

첫 번째 매개 변수:

키 경로(문자열 값)

두 번째 매개 변수:

새 키 경로(문자열 값)

사용법:

ApplyMappedKey(<키 경로>, [새 키 경로]);

예제:

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

ApplyMappedSubKeys

레지스트리 키와 모든 레지스트리 키 값, 모든 레지스트리 하위 키 또는 ini 파일 섹션과 모든 ini 파일 섹션 값을 원본에서 대상 컴퓨터로 적용합니다. 일부 값 이름 또는 값 데이터가 디렉터리 경로인 경우 적절한 경로로 매핑됩니다. 이 명령은 두 개의 매개 변수를 사용할 수 있습니다. 이미 저장된 키만 적용할 수 있습니다.

첫 번째 매개 변수:

키 경로(문자열 값)

두 번째 매개 변수:

새 키 경로(문자열 값)

사용법:

ApplyMappedSubKeys(<키 경로>, [새 키 경로]);

예제:

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

ApplyMappedValue

레지스트리 키 값 또는 .ini 파일 값을 원본에서 대상 컴퓨터로 적용합니다. 값 이름 또는 값이 디렉터리 경로인 경우 적절한 경로로 매핑됩니다. 이 명령은 6개의 매개 변수를 사용할 수 있습니다. 매핑된 것으로 저장된 값만 매핑된 것으로 적용할 수 있습니다..

첫 번째 매개 변수:

키 경로(문자열 값)

두 번째 매개 변수:

값 이름(문자열 값)

참고: 값이 기본값인 경우 두 번째 매개 변수는 NULL("")이어야 합니다.

세 번째 매개 변수:

새 키 경로(문자열 값)

참고: 값을 새 위치로 이동하지 않을 경우 세 번째 매개 변수는 NULL("")이어야 합니다.

네 번째 매개 변수:

구분 기호(문자열 값)

다섯 번째 매개 변수:

짧은 경로 표시기(부울 값)

여섯 번째 매개 변수:

이동하는 경우 새 값 이름(문자열 값)

사용법:

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 파일에서 키와 모든 키 값 및 하위 키를 삭제합니다. 키를 삭제하는 데 문제가 발생할 경우 False를 반환합니다. 키가 존재하지 않을 경우 True를 반환합니다. 경로가 ini 파일의 경로인 경우에는 ini 파일의 모든 섹션이 삭제됩니다.

첫 번째 매개 변수:

키 경로(문자열 값)

예제:

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

DeleteValue

레지스트리 또는 ini 파일에서 값을 삭제합니다. 값을 삭제하는 데 문제가 있을 경우 False를 반환합니다. 값이 존재하지 않을 경우 True를 반환합니다.

첫 번째 매개 변수:

키 경로(문자열 값)

두 번째 매개 변수:

값 이름(문자열 값)

예제:

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 쿼리를 나타냅니다.

Data

값을 나타냅니다.

Type

값 유형을 나타냅니다.

다음은 허용되는 레지스트리 값입니다.

값	형식	예제
STRING	문자열	"Brian"
DWORD	숫자	"1999"
BINARY	바이너리	"af 45 99 31"
DWORD_LITTLE_ENDIAN	숫자	"1234"
DWORD_BIG_ENDIAN	숫자	"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", "");