VShadow 도구 및 샘플

VShadow는 볼륨 섀도 복사본을 만들고 관리하는 데 사용할 수 있는 명령줄 도구입니다.

참고 항목

VShadow는 Windows Vista 이상용 Microsoft Windows SDK(소프트웨어 개발 키트)에 포함되어 있습니다. VSS 7.2 SDK에는 Windows Server 2003에서만 실행되는 VShadow 버전이 포함되어 있습니다. Windows SDK 및 VSS 7.2 SDK 다운로드에 대한 자세한 내용은 볼륨 섀도 복사본 서비스를 참조하세요.

VShadow 도구는 명령줄 옵션 및 선택적 플래그를 사용하여 수행할 작업을 식별합니다. 명령줄 옵션 없이 사용할 경우 VShadow 명령은 새 섀도 복사본 집합을 만듭니다.

VShadow 명령은 다음 작업을 수행합니다.

섀도 복사본 집합 만들기

vshadow [OptionalFlags] VolumeList

이 명령은 새 섀도 복사본 집합을 만듭니다.

VolumeList 는 볼륨 이름 목록입니다. VShadow는 목록의 각 볼륨에 대해 하나의 섀도 복사본을 만듭니다. 볼륨 이름은 필요에 따라 백슬래시(\)로 종료할 수 있습니다. 예를 들어 둘 다 C: 유효한 C:\ 볼륨 이름입니다. 탑재된 폴더(예 C:\DirectoryName: ) 또는 볼륨 GUID 이름(예 \\?\Volume{bbbbcccc-1111-dddd-2222-eeee3333ffff}: )을 지정할 수도 있습니다.

OptionalFlags 는 다음 표에서 선택적 플래그 값의 비트 마스크입니다.

선택적 플래그 값 설명
-ad 이 선택적 플래그는 차등 하드웨어 섀도 복사본을 지정합니다. 이 플래그와 -ap 플래그는 함께 사용할 수 없습니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
-ap 이 선택적 플래그는 플렉스 하드웨어 섀도 복사본을 지정합니다. 이 플래그와 -ad 플래그는 함께 사용할 수 없습니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
-bc=File.xml 이 선택적 플래그는 전송할 수 없는 섀도 복사본을 지정하고 백업 구성 요소 문서를 지정된 파일에 저장합니다. 이 파일은 후속 복원 작업에서 사용할 수 있습니다. 이 플래그와 -t 플래그는 함께 사용할 수 없습니다 .
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
-exec=<Command> 이 선택적 플래그는 섀도 복사본을 만든 후 VShadow 도구가 종료되기 전에 명령 또는 스크립트를 실행합니다. <Command> 는 실행 파일 셸 명령 또는 CMD 파일을 지정할 수 있습니다. 셸 명령을 지정하는 경우 명령 매개 변수를 지정할 수 없습니다.
참고: 보안상의 이유로 구현을 단순하게 -exec 유지하기 위해 선택적 플래그는 명령이나 스크립트에 전달될 매개 변수를 허용하지 않습니다. 선택적 플래그에 -exec 전달된 전체 문자열은 단일 CMD 또는 EXE 파일로 처리됩니다. 이 제한 사항에 대한 자세한 내용은 VShadow 소스 코드를 참조하세요.
-forcerevert 이 선택적 플래그는 모든 디스크 서명을 되돌릴 수 있는 경우에만 섀도 복사 작업이 완료되도록 지정합니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
Windows Server 2003: 지원되지 않습니다.
-mask 이 선택적 플래그는 섀도 복사본 집합이 손상되었을 때 컴퓨터에서 섀도 복사본 LUN을 마스킹하도록 지정합니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
Windows Server 2003: 지원되지 않습니다.
-nar 이 선택적 플래그는 자동 복구 없이 섀도 복사본을 지정합니다. 이 옵션에 대한 자세한 내용은 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES] 열거형의 플래그에 대한 VSS_VOLSNAP_ATTR_NO_AUTORECOVERY 설명서를 참조하세요.
-norevert 이 선택적 플래그는 디스크 서명을 되돌리지 않도록 지정합니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
Windows Server 2003: 지원되지 않습니다.
-nw 이 선택적 플래그는 기록기를 포함하지 않고 섀도 복사본을 지정합니다. 기록기 참여 없이 섀도 복사본에 대한 자세한 내용은 섀도 복사본 만들기 세부 정보를 참조 하세요. 이 플래그와 -wi -wx 플래그는 함께 사용할 수 없습니다.
-p 이 선택적 플래그는 영구 섀도 복사본을 지정합니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
-rw 이 선택적 플래그는 섀도 복사본 집합이 손상될 때 섀도 복사본 LUN을 읽기/쓰기로 지정합니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
Windows Server 2003: 지원되지 않습니다.
-scsf 이 선택적 플래그는 클라이언트에서 액세스할 수 있는 섀도 복사본을 지정합니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
-script=File.cmd 이 선택적 플래그는 생성된 섀도 복사본과 관련된 환경 변수(예: 섀도 복사본 ID 및 섀도 복사본 집합 ID)를 포함하는 CMD 파일을 생성합니다.
-t=File.xml 이 선택적 플래그는 전송 가능한 섀도 복사본을 지정하고 백업 구성 요소 문서를 매개 변수로 지정된 File.xml 파일에 저장합니다. 이 파일은 후속 가져오기 및/또는 복원 작업에서 사용할 수 있습니다. 이 플래그와 플래그는 -bc 함께 사용할 수 없습니다.
Windows Server 2003, Standard Edition 및 Windows Server 2003, Web Edition: 전송 가능한 섀도 복사본은 지원되지 않습니다. 모든 버전의 Windows Server 2003 SP1(서비스 팩 1)은 전송 가능한 섀도 복사본을 지원합니다.
-tr 이 선택적 플래그는 섀도 복사본을 만드는 동안 TxF 복구가 적용되도록 지정합니다.
참고: 이 플래그는 Windows 서버 운영 체제에서만 지원됩니다.
-tracing 이 선택적 플래그는 문제 해결에 사용할 수 있는 자세한 정보 출력을 생성합니다.
-wait 이 선택적 플래그를 사용하면 VShadow 도구가 종료되기 전에 사용자 확인을 기다립니다.
-wi=<Writer> 이 선택적 플래그는 지정된 작성기 또는 구성 요소가 섀도 복사본에 포함되어 있는지 확인합니다. <Writer> 구성 요소 경로, 작성기 이름, 기록기 ID 또는 기록기 인스턴스 ID를 지정할 수 있습니다. 이 플래그와 플래그는 -nw 함께 사용할 수 없습니다.
-wx=<Writer> 이 선택적 플래그는 지정된 작성기 또는 구성 요소가 섀도 복사본에서 제외되어 있는지 확인합니다. <Writer> 구성 요소 경로, 작성기 이름, 기록기 ID 또는 기록기 인스턴스 ID를 지정할 수 있습니다. 이 플래그와 플래그는 -nw 함께 사용할 수 없습니다.

섀도 복사본 집합 가져오기

vshadow [OptionalFlags] -i=File.xml

-i 명령줄 옵션은 전송 가능한 섀도 복사본 집합을 가져옵니다.

참고 항목

이 명령줄 옵션은 Windows Server 운영 체제에서만 지원됩니다.

파일은 File.xml 전송 가능한 섀도 복사본 집합에 대한 Backup 구성 요소 문서 파일이어야 하며, 이 파일은 플래그 또는 -bc 선택적 플래그를 사용하여 -t 만들어야 합니다.

섀도 복사본 집합은 선택적 플래그를 사용하여 만든 경우 영구 섀도 -p 복사본입니다. 전송 가능한 섀도 복사본 집합이 존재하지 않는 경우 섀도 복사본 만들기 명령이 실행되는 동안 잠시 동안 표시되고 명령이 반환될 때 자동으로 삭제됩니다. 선택적 플래그를 사용하여 -exec 섀도 복사본 집합을 만들어 VShadow -i를 호출하는 CMD 파일을 실행하여 섀도 복사본을 만드는 동안에만 존재하지 않는 섀도 복사본을 가져올 수 있습니다.

-i 명령줄 옵션은 다른 명령줄 옵션과 결합할 수 없습니다.

OptionalFlags 는 다음 표에서 선택적 플래그 값의 비트 마스크입니다.

선택적 플래그 값 설명
-exec=<Command> 이 선택적 플래그는 섀도 복사본을 가져온 후 VShadow 도구가 종료되기 전에 명령 또는 스크립트를 실행합니다. <Command> 는 실행 파일 셸 명령 또는 CMD 파일을 지정할 수 있습니다. 셸 명령을 지정하는 경우 명령 매개 변수를 지정할 수 없습니다.
-tracing 이 선택적 플래그는 문제 해결에 사용할 수 있는 자세한 정보 출력을 생성합니다.
-wait 이 선택적 플래그를 사용하면 VShadow 도구가 종료되기 전에 사용자 확인을 기다립니다.

섀도 복사본 속성 쿼리

vshadow -q

vshadow -qx=<ShadowCopySetId>

vshadow -s=<ShadowCopyId>

-q 명령줄 옵션은 컴퓨터의 모든 섀도 복사본의 속성을 나열합니다.

-qx 명령줄 옵션에는 ID가 지정된 섀도 복사본 집합에 있는 모든 섀도 복사본의 속성이 나열됩니다<ShadowCopySetId>.

-s 명령줄 옵션에는 ID가 지정된 섀도 복사본의 속성이 나열됩니다<ShadowCopyId>.

이러한 명령줄 옵션은 IVssBackupComponents::Query 및 IVssBackupComponents::GetSnapshotProperties의 조합을 사용하여 지정된 섀도 복사본 집합의 속성을 가져옵니다.

-q, -qx-s 명령줄 옵션은 함께 사용할 수 없으며 다른 명령줄 옵션과 결합할 수 없습니다.

섀도 복사본 삭제

vshadow** -da

vshadow -do

vshadow -dx=<ShadowCopySetId>

vshadow -ds=<ShadowCopyId>

-da 명령은 컴퓨터의 모든 섀도 복사본을 삭제합니다.

참고 항목

-da 명령줄 옵션을 사용하려면 사용자 확인이 필요합니다.

-do 명령줄 옵션은 컴퓨터에서 가장 오래된 섀도 복사본을 삭제합니다.

-dx 명령줄 옵션은 ID<ShadowCopySetId>가 지정된 섀도 복사본 집합의 모든 섀도 복사본을 삭제합니다.

-ds 명령줄 옵션은 ID<ShadowCopyId>가 지정된 섀도 복사본을 삭제합니다.

이러한 명령줄 옵션은 영구 섀도 복사본만 사용됩니다. 존재하지 않는 섀도 복사본은 VShadow 만들기 명령이 종료될 때 자동으로 삭제되므로 명시적으로 삭제할 필요가 없습니다.

-da, -do, -dx-ds 명령줄 옵션은 함께 사용할 수 없으며 다른 명령줄 옵션과 결합할 수 없습니다.

섀도 복사본 집합 분리

vshadow -b=<ShadowCopySetId>

vshadow -bw=<ShadowCopySetId>

-b=<ShadowCopySetId> 명령줄 옵션은 섀도 복사본 집합의 각 섀도 복사본을 독립 실행형 읽기 전용 볼륨으로 변환합니다.

-bw=<ShadowCopySetId> 명령줄 옵션은 섀도 복사본 집합의 각 섀도 복사본을 독립 실행형 쓰기 가능 볼륨으로 변환합니다.

참고 항목

-b 명령줄 및 -bw 명령줄 옵션은 Windows 서버 운영 체제에서만 지원됩니다.

섀도 복사본 집합을 분리하는 방법에 대한 자세한 내용은 섀도 복사본 분리를 참조 하세요.

섀도 복사본 집합이 끊어진 후에는 섀도 복사본 집합과 개별 섀도 복사본이 더 이상 존재하지 않으며 VSS 명령을 사용하여 관리할 수 없습니다.

섀도 복사본 집합은 선택적 플래그를 사용하여 -p 만든 경우 영구적입니다. 전송 가능한 섀도 복사본 집합이 존재하지 않는 경우 섀도 복사본 만들기 명령이 실행되는 동안 잠시 동안 표시되고 명령이 반환될 때 자동으로 삭제됩니다. 선택적 플래그를 사용하여 -exec 섀도 복사본 집합을 만들어서 호출 vshadow -b 하거나 vshadow -bw호출하는 CMD 파일을 실행하여 섀도 복사본을 만드는 동안에만 존재하지 않는 섀도 복사본 집합을 끊을 수 있습니다.

-b 명령줄 및 -bw 명령줄 옵션은 함께 사용할 수 없으며 다른 명령줄 옵션과 결합할 수 없습니다.

BreakSnapshotSetEx 메서드를 사용하여 섀도 복사본 집합 분리

vshadow -bex

-bex 명령줄 옵션은 선택적 -mask, -rw-forcerevert-norevert 플래그로 지정된 옵션에 따라 섀도 복사본 집합을 중단합니다. 이 명령줄 옵션은 명령줄 옵션과 -bw 유사 -b 합니다. -bex 명령줄 옵션은 IVssBackupComponentsEx2::BreakSnapshotSetEx 메서드를 사용하는 반면-b, -bw 명령줄 옵션은 IVssBackupComponents::BreakSnapshotSet 메서드를 사용합니다.

섀도 복사본 집합을 분리하는 방법에 대한 자세한 내용은 섀도 복사본 분리를 참조 하세요.

참고 항목

-bex 명령줄 옵션은 Windows 서버 운영 체제에서만 지원됩니다.

vshadow -bex -mask

플래그는 -mask 섀도 복사본 LUN이 호스트에서 마스킹되도록 지정합니다. 플래그를 -mask 지정 -rw하면 , -forcerevert-norevert 플래그를 지정할 수 없습니다.

vshadow -bex -rw

플래그는 -rw 섀도 복사본 LUN이 읽기/쓰기 볼륨으로 호스트에 노출되도록 지정합니다.

vshadow -bex -forcerevert

플래그는 -forcerevert 모든 섀도 복사본 LUN의 디스크 식별자를 원래 LUN의 디스크로 되돌려지도록 지정합니다. 그러나 원래 LUN 중 하나라도 시스템에 있으면 작업이 실패하고 식별자가 되돌려지지 않습니다. 이 플래그와 플래그는 -norevert 함께 사용할 수 없습니다.

vshadow -bex -norevert

플래그는 -norevert 섀도 복사본 LUN 디스크 식별자를 되돌리지 않음을 지정합니다. 이 플래그와 플래그는 -forcerevert 함께 사용할 수 없습니다.

로컬로 섀도 복사본 노출

vshadow -el=<ShadowCopyId>,<LocalEmptyDirectory>

vshadow -el=<ShadowCopyId>,<UnusedDriveLetter>

-el 명령줄 옵션은 탑재된 폴더 또는 드라이브 문자를 영구 섀도 복사본에 할당합니다. 나중에 섀도 복사본 집합을 중단하도록 호출 vshadow -bw 하지 않는 한 볼륨 콘텐츠는 읽기 전용으로 유지됩니다.

참고 항목

존재하지 않는 섀도 복사본 및 클라이언트에서 액세스할 수 있는 섀도 복사본은 로컬로 노출할 수 없습니다.

예를 들어 기존 영구 섀도 복사본의 GUID이고 X: 사용되지 않는 드라이브 문자인 경우 {bbbbcccc-1111-dddd-2222-eeee3333ffff} 다음 명령은 아래X:의 섀도 복사본을 노출합니다.

vshadow -el={bbbbcccc-1111-dddd-2222-eeee3333ffff},x:

다음 예제에서는 탑재된 폴더 C:\ShadowCopies\June23아래에 동일한 섀도 복사본을 노출하는 방법을 보여줍니다.

mkdir c:\ShadowCopies\June23

vshadow -el={bbbbcccc-1111-dddd-2222-eeee3333ffff},c:\ShadowCopies\June23

-el 명령줄 옵션은 다른 명령줄 옵션과 결합할 수 없습니다.

원격으로 섀도 복사본 노출

vshadow -er=<ShadowCopyId>,<UnusedShareName>

vshadow -er=<ShadowCopyId>,<UnusedShareName>,<PathFromRootOnShadow>

-er 명령줄 옵션은 섀도 복사본의 루트 디렉터리(또는 하위 디렉터리)에 읽기 전용 공유 이름을 할당합니다. 이후에 섀도 복사본 집합을 중단하도록 호출 vshadow -bw 하지 않는 한 공유 콘텐츠는 읽기 전용으로 유지됩니다.

참고 항목

클라이언트에서 액세스할 수 있는 섀도 복사본은 원격으로 노출할 수 없습니다.

예를 들어 기존 영구 섀도 복사본의 GUID이고 share_123 사용되지 않는 공유 이름인 경우 {bbbbcccc-1111-dddd-2222-eeee3333ffff} 다음 명령은 아래share_123의 섀도 복사본을 노출합니다.

vshadow -er={bbbbcccc-1111-dddd-2222-eeee3333ffff},share_123

다음 예제에서는 동일한 공유 아래에 있는 동일한 섀도 복사본의 하위 트리(이름) Folder1\Folder2만 노출하는 방법을 보여 줍니다.

vshadow -er={bbbbcccc-1111-dddd-2222-eeee3333ffff},share_123,Folder1\Folder2

-er 명령줄 옵션은 다른 명령줄 옵션과 결합할 수 없습니다.

기록기 상태 및 메타데이터 나열

vshadow -ws

vshadow -wm

vshadow -wm2

vshadow -wm3

-ws 명령줄 옵션은 현재 컴퓨터에서 실행 중인 VSS 기록기를 열거하고 해당 상태를 설명합니다. 이 명령은 Vssadmin list writers 명령과 동일합니다. 가능한 상태 값Stable은 6가지입니다. , Failed, Unknown, FrozenWaiting for freezeWaiting for completion.

-wm 명령줄 옵션은 영향을 받는 볼륨을 포함하여 기록기 메타데이터의 요약을 나열합니다.

-wm2 명령줄 옵션은 모든 기록기 메타데이터를 나열합니다.

-wm3 명령줄 옵션은 모든 기록기 메타데이터를 원시 XML 형식으로 나열합니다.

Windows Vista 및 Windows Server 2003: -wm3 명령줄 옵션은 지원되지 않습니다.

이 정보를 사용하여 볼륨 섀도 복사본 집합에 포함할 볼륨을 결정할 수 있습니다.

참고 항목

작성기 상태가 안정 상태이거나 완료 대기 중이면 작성기가 안정적인 상태로 간주되어 다음 백업을 준비할 수 있습니다.

-ws, -wm, -wm2-wm3 명령줄 옵션은 함께 사용할 수 없으며 다른 명령줄 옵션과 결합할 수 없습니다.

복원 작업 수행

vshadow [OptionalFlags] -r=File.xml

vshadow [OptionalFlags] -rs=File.xml

-r 명령줄 옵션은 복원 작업을 수행합니다.

-rs 명령줄 옵션은 시뮬레이션된 복원 작업을 수행합니다.

파일은 File.xml 또는 -bc 선택적 플래그를 사용하여 만든 -t 섀도 복사본 집합에 대한 Backup 구성 요소 문서 파일이어야 합니다.

-r 명령줄 및 -rs 명령줄 옵션은 함께 사용할 수 없으며 다른 명령줄 옵션과 결합할 수 없습니다.

OptionalFlags 는 다음 표에서 선택적 플래그 값의 비트 마스크입니다.

선택적 플래그 값 설명
-wi=<Writer> 이 선택적 플래그는 지정된 작성기 또는 구성 요소가 복원에 포함되어 있는지 확인합니다. <Writer> 구성 요소 경로, 작성기 이름, 기록기 ID 또는 기록기 인스턴스 ID를 지정할 수 있습니다.
-wx=<Writer> 이 선택적 플래그는 지정된 작성기 또는 구성 요소가 복원에서 제외되어 있는지 확인합니다. <Writer> 구성 요소 경로, 작성기 이름, 기록기 ID 또는 기록기 인스턴스 ID를 지정할 수 있습니다.
-exec=<Command> 이 선택적 플래그는 기록기에 전송되는 사전 복원 이벤트와 복원 후 이벤트 간에 명령 또는 스크립트를 실행합니다. <Command> 는 실행 파일 셸 명령 또는 CMD 파일을 지정할 수 있습니다. 셸 명령을 지정하는 경우 명령 매개 변수를 지정할 수 없습니다.
-tracing 이 선택적 플래그는 문제 해결에 사용할 수 있는 자세한 정보 출력을 생성합니다.

이전 섀도 복사본으로 되돌리기

vshadow -revert=<ShadowCopyId>

참고 항목

이 명령줄 옵션은 Windows Server 운영 체제에서만 지원됩니다.

Windows Server 2008 및 Windows Server 2003: 지원되지 않습니다.

-revert 명령줄 옵션은 볼륨을 ID가 지정된 이전 섀도 복사본으로 <ShadowCopyId>되돌려 줍니다.

-revert 명령줄 옵션은 다른 명령줄 옵션과 결합할 수 없습니다.

LUN 다시 동기화

vshadow** -addresync=<ShadowCopyId> -resync=<BCDFileName> [OptionalResyncFlags]

vshadow -addresync=<ShadowCopyId>, <TargetVolumeDriveLetter> -resync=<BCDFileName> [OptionalResyncFlags]

-addresync 명령줄 옵션은 LUN 다시 동기화 작업에 포함할 볼륨을 지정합니다. 매개 변수는 <ShadowCopyId> 섀도 복사본의 식별자를 지정합니다. 선택적 <TargetVolumeDriveLetter> 매개 변수는 섀도 복사본 볼륨의 내용을 복사할 대상 볼륨을 지정합니다.

-resync 명령줄 옵션은 LUN 다시 동기화 작업을 시작합니다. 작업이 완료되면 각 대상 LUN의 서명이 대상 볼륨 LUN의 서명과 동일해야 합니다. 매개 변수는 <BCDFileName> Backup 구성 요소 문서를 포함하는 XML 파일의 이름을 지정합니다.

참고 항목

-addresync 명령줄 및 -resync 명령줄 옵션은 Windows 서버 운영 체제에서만 지원됩니다.

Windows Server 2008 및 Windows Server 2003: 지원되지 않습니다.

OptionalResyncFlags 는 다음 표에서 선택적 플래그 값의 비트 마스크입니다.

선택적 플래그 값 설명
-revertsig 이 선택적 플래그는 작업이 완료된 후 각 대상 LUN의 서명이 대상 볼륨 LUN이 아니라 섀도 복사본을 만드는 데 사용된 원래 LUN의 서명과 동일하도록 지정합니다.
참고: 플래그는 -revertsig Windows 서버 운영 체제에서만 지원됩니다.
Windows Server 2008 및 Windows Server 2003: 지원되지 않습니다.
-novolcheck 이 선택적 플래그는 VSS 서비스에서 LUN 다시 동기화 작업으로 덮어쓸 선택되지 않은 볼륨을 확인하지 않도록 지정합니다.
참고: 플래그는 -novolcheck Windows 서버 운영 체제에서만 지원됩니다.
Windows Server 2008 및 Windows Server 2003: 지원되지 않습니다.

참고 항목

볼륨 섀도 복사본 서비스

볼륨 섀도 복사본 API 참조