일반 규칙

이 항목에서는 XML 도우미 함수에 대해 설명합니다.

이 항목의 내용

일반 XML 지침

도우미 함수

일반 XML 지침

.xml 파일을 수정하려면 다음 지침을 잘 알고 있어야 합니다.

  • XML 스키마

    사용자 상태 마이그레이션 도구(USMT) 5.0 XML 스키마인 MigXML.xsd를 사용하여 마이그레이션 .xml 파일을 쓰고 유효성을 검사할 수 있습니다.

  • 충돌

    일반적으로 XML 스키마 내에 충돌이 있는 경우 더 구체적인 패턴이 우선적으로 적용됩니다. 자세한 내용은 충돌 및 우선 순위를 참조하세요.

  • 필수 요소

    마이그레이션 .xml 파일의 필수 요소는 <migration>, <component>, <role> 및 **<rules>**입니다.

  • 필수 자식 요소

    • USMT 필수 자식 요소를 지정하지 않더라도 가 오류로 인해 실패하지는 않지만, 마이그레이션에 적용할 부모 요소의 필수 자식 요소를 지정해야 합니다.

    • 필수 자식 요소는 요소의 첫 번째 정의에만 적용됩니다. 이러한 요소를 정의한 후 참조하여 이름을 지정할 경우 필수 자식 요소는 적용되지 않습니다. 예를 들어 <detects name="Example">에서 **<namedElements>**을 정의하고 이 요소를 참조하도록 <detects name="Example"/>에서 **<component>**을 지정하는 경우 <namedElements> 내의 정의에는 필수 자식 요소가 필요하지만 <component> 요소는 필수 자식 요소가 필요하지 않습니다.

  • 대괄호가 있는 파일 이름

    파일 이름에 대괄호 문자([ 또는 ])가 포함된 파일을 마이그레이션할 경우 대괄호 문자가 유효하려면 대괄호 바로 앞에 캐럿(^) 문자를 삽입해야 합니다. 예를 들어 파일 이름이 File.txt인 경우 <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> 대신 <pattern type="File">c:\documents\mydocs [file].txt]</pattern>을 지정해야 합니다.

  • 따옴표 사용

    코드를 따옴표로 묶을 때는 큰따옴표("")나 작은따옴표('')를 사용할 수 있습니다.

도우미 함수

XML 요소 라이브러리에서 XML 도우미 함수를 사용하여 마이그레이션 동작을 변경할 수 있습니다. .xml 파일에서 도우미 함수를 사용하기 전에 다음에 유의하세요.

  • 모든 매개 변수는 문자열입니다.

  • NULL 매개 변수는 비워둘 수 있습니다.

    기본값 규칙을 사용하는 매개 변수와 마찬가지로 목록의 끝에 NULL 매개 변수가 있는 경우 이 매개 변수를 생략할 수 있습니다. 예를 들어 다음 함수는

    SomeFunction("My String argument",NULL,NULL)
    

    다음과 같습니다.

    SomeFunction("My String argument")
    
  • 모든 도우미 함수에 사용되는 인코딩된 위치는 개체 이름을 나타내는 명확한 문자열 표현입니다.

    노드 부분으로 구성되며 필요에 따라 대괄호로 묶인 리프가 뒤에 올 수 있습니다. 이렇게 하면 노드와 리프를 명확하게 구분할 수 있습니다.

    예를 들어 C:\Windows\Notepad.exe 파일은 **c:\Windows[Notepad.exe]**로 지정합니다. 마찬가지로 C:\Windows\System32 디렉터리는 c:\Windows\System32로 지정합니다. 이 경우 [] 문자가 없는 데 유의하세요.

    레지스트리도 비슷한 방식으로 표시됩니다. 레지스트리 키의 기본값은 빈 [] 구문으로 표현됩니다. 예를 들어 HKLM\SOFTWARE\MyKey 레지스트리 키의 기본값은 **HKLM\SOFTWARE\MyKey[]**입니다.

  • 실제 위치를 지정할 때와 유사한 방식으로 위치 패턴을 지정합니다.

    단, 노드 부분과 리프 부분에 모두 패턴을 사용할 수 있다는 차이가 있습니다. 그러나 노드의 패턴이 리프까지 확장되지는 않습니다.

    예를 들어 c:\Windows\* 패턴은 \Windows 디렉터리 및 모든 하위 디렉터리와 일치하지만, 디렉터리 내에 있는 파일과 일치하지는 않습니다. 파일도 일치시키려면 **c:\Windows\*[*]**를 지정해야 합니다.

참고 항목

기타 리소스

USMT XML 참조