Strumento e esempio di VShadow

VShadow è uno strumento da riga di comando che è possibile usare per creare e gestire copie shadow del volume.

Nota

VShadow è incluso in Microsoft Windows Software Development Kit (SDK) per Windows Vista e versioni successive. L'SDK VSS 7.2 include una versione di VShadow che viene eseguita solo su Windows Server 2003. Per informazioni sul download di Windows SDK e VSS 7.2 SDK, vedere il Servizio Copia Shadow dei volumi.

Lo strumento VShadow usa opzioni della riga di comando e flag facoltativi per identificare il lavoro da eseguire. Se usato senza opzioni della riga di comando, il comando VShadow crea un nuovo set di copie shadow.

I comandi VShadow eseguono le operazioni seguenti:

• Creazione di un set di copie ombra
• Importazione di un set di copie shadow
• Esecuzione di query su proprietà copia shadow
• Eliminazione di Copie Shadow
• Interruzione di un set di copie ombra
• Interruzione di un set di copie shadow tramite il metodo BreakSnapshotSetEx
• Rendere visibile una copia ombra localmente
• Esposizione di una copia shadow da remoto
• Elencare lo stato e i metadati di Writer
• Esecuzione di operazioni di ripristino
• Ripristino di una copia ombra precedente
• Risincronizzazione dei LUN

Creazione di un set di copie shadow

vshadow [OptionalFlags] VolumeList

Questo comando crea un nuovo set di copie ombra.

VolumeList è un elenco di nomi di volumi. VShadow crea una copia shadow per ogni volume nell'elenco. Un nome di volume può facoltativamente essere terminato con una barra rovesciata (\). Ad esempio, sia C: che C:\ sono nomi di volume validi. È anche possibile specificare cartelle montate (ad esempio, C:\DirectoryName) o nomi GUID del volume (ad esempio, \\?\Volume{bbbbcccc-1111-dddd-2222-eeee3333ffff}).

OptionalFlags è una maschera di bit di valori di flag facoltativi della tabella seguente.

Valore del segnalatore facoltativo	Descrizione
-ad	Questo flag facoltativo specifica copie shadow hardware differenziali. Questo flag e il flag -ap si escludono a vicenda. Nota: questo flag è supportato solo nei sistemi operativi Windows Server.
-ap	Questo flag opzionale specifica le copie shadow hardware del plex. Questo flag e il flag -ad si escludono a vicenda. Nota: questo flag è supportato solo nei sistemi operativi Windows Server.
-bc=File.xml	Questo flag facoltativo specifica copie shadow non trasportabili e salva i Documenti dei Componenti di Backup nel file specificato. Questo file può essere usato in un'operazione di ripristino successiva. Questo flag e il flag -t si escludono a vicenda. Nota: questo flag è supportato solo nei sistemi operativi Windows Server.
-exec=<Command>	Questo flag facoltativo esegue un comando o uno script dopo la creazione delle copie shadow, ma prima che lo strumento VShadow venga chiuso. <Command> può specificare un comando della shell eseguibile o un file CMD. Se specifica un comando della shell, non è possibile specificare parametri di comando. Nota: per motivi di sicurezza e per mantenere semplice l'implementazione, il -exec flag facoltativo non accetterà parametri da passare al comando o allo script. L'intera stringa passata al -exec flag facoltativo viene considerata come un singolo file CMD o EXE. Per altre informazioni su questa limitazione, vedere il codice sorgente VShadow.
-forcerevert	Questo flag facoltativo specifica che l'operazione di copia shadow deve essere completata solo se è possibile ripristinare tutte le firme del disco. Nota: questo flag è supportato solo nei sistemi operativi Windows Server. Windows Server 2003: non supportato.
-mask	Questo flag facoltativo specifica che i LUN di copie ombra devono essere mascherati dal computer quando il set di copie ombra viene interrotto. Nota: questo flag è supportato solo nei sistemi operativi Windows Server. Windows Server 2003: non supportato.
-nar	Questo flag facoltativo specifica copie ombra senza ripristino automatico. Per altre informazioni su questa opzione, vedere la documentazione relativa al VSS_VOLSNAP_ATTR_NO_AUTORECOVERY flag dell'enumerazione _VSS_VOLUME_SNAPSHOT_ATTRIBUTES].
-norevert	Questo flag facoltativo specifica che le firme del disco non devono essere ripristinate. Nota: questo flag è supportato solo nei sistemi operativi Windows Server. Windows Server 2003: non supportato.
-nw	Questo flag facoltativo specifica le copie shadow senza coinvolgere i writer. Per ulteriori informazioni sulle copie shadow senza la partecipazione del writer, vedere Dettagli sulla creazione di copie shadow. Questa bandiera e le bandiere -wi e -wx si escludono a vicenda.
-p	Questo flag facoltativo specifica le copie shadow persistenti. Nota: questo flag è supportato solo nei sistemi operativi Windows Server.
-rw	Questo flag facoltativo specifica che i LUN di copia shadow devono essere abilitati per la lettura/scrittura quando l'insieme di copie shadow viene interrotto. Nota: questo flag è supportato solo nei sistemi operativi Windows Server. Windows Server 2003: non supportato.
-scsf	Questo flag facoltativo specifica copie ombra accessibili dal client. Nota: questo flag è supportato solo nei sistemi operativi Windows Server.
-script=File.cmd	Questo flag facoltativo genera un file CMD contenente variabili di ambiente correlate alle copie ombra create, ad esempio gli ID copia ombra e gli ID del set di copie ombra.
-t=File.xml	Questo flag facoltativo specifica copie shadow trasportabili e archivia il documento dei componenti di backup nel file specificato dal parametro File.xml. Questo file può essere usato in un'operazione di importazione e/o ripristino successiva. Questo flag e la -bc bandiera si escludono a vicenda. Windows Server 2003, edizione Standard e Windows Server 2003, Web Edition: le copie shadow trasportabili non sono supportate. Tutte le edizioni di Windows Server 2003 con Service Pack 1 (SP1) supportano copie shadow trasportabili.
-tr	Questo flag facoltativo specifica che il ripristino TxF deve essere applicato durante la creazione della copia di ombra. Nota: questo flag è supportato solo nei sistemi operativi Windows Server.
-tracing	Questo indicatore facoltativo genera un output dettagliato che può essere utilizzato per la risoluzione dei problemi.
-wait	Questo flag facoltativo fa sì che lo strumento VShadow attenda la conferma dell'utente prima di uscire.
-wi=<Writer>	Questo flag facoltativo verifica che il writer o il componente specificato sia incluso nella copia shadow. <Writer> può specificare un percorso del componente, il nome dello scrittore, l'ID dello scrittore o l'ID istanza dello scrittore. Questa bandiera e la bandiera -nw si escludono a vicenda.
-wx=<Writer>	Questo flag facoltativo verifica che il writer o il componente specificato sia escluso dalla copia ombra. <Writer> può specificare un percorso del componente, il nome del writer, l'ID del writer o l'ID istanza del writer. Questi indicatori e il flag -nw si escludono a vicenda.

Importazione di un set di copie ombra

vshadow [OptionalFlags] -i=File.xml

L'opzione -i della riga di comando importa un insieme di copie ombra trasportabili.

Nota

Questa opzione della riga di comando è supportata solo nei sistemi operativi Windows Server.

Il File.xml file deve essere un file Documento dei Componenti di Backup per un set di copia ombra trasportabile creato con l'opzione facoltativa -t o -bc.

Un set di copie shadow è una copia shadow persistente se è stato creato con l'-p opzione facoltativa. Se il set di copie shadow trasportabili non è persistente, viene visualizzato per un breve periodo di tempo durante l'esecuzione del comando di creazione della copia shadow e viene eliminato automaticamente al termine del comando. È possibile importare copie shadow non persistenti solo durante la creazione del set di copie shadow, creando il set di copie shadow utilizzando il -exec flag facoltativo per eseguire un file CMD che chiama VShadow -i.

L'opzione -i della riga di comando non può essere combinata con altre opzioni della riga di comando.

OptionalFlags è una maschera di bit dei valori di flag opzionali presenti nella tabella seguente.

Valore facoltativo della bandiera	Descrizione
-exec=<Command>	Questo flag facoltativo esegue un comando o uno script dopo l'importazione delle copie shadow, ma prima che lo strumento VShadow venga chiuso. <Command> può specificare un comando della shell eseguibile o un file CMD. Se specifica un comando della shell, non è possibile specificare parametri di comando.
-tracing	Questo flag facoltativo genera un output dettagliato che può essere utilizzato per risolvere i problemi.
-wait	Questo flag facoltativo fa sì che lo strumento VShadow attenda la conferma dell'utente prima di uscire.

Consultazione delle proprietà delle copie ombra

vshadow -q

vshadow -qx=<ShadowCopySetId>

vshadow -s=<ShadowCopyId>

L'opzione -q della riga di comando elenca le proprietà di tutte le copie shadow nel sistema.

L'opzione -qx della riga di comando elenca le proprietà di tutte le copie shadow nel set di copie shadow il cui ID è specificato da <ShadowCopySetId>.

L'opzione -s della riga di comando elenca le proprietà della copia shadow il cui ID è specificato da <ShadowCopyId>.

Queste opzioni della riga di comando usano una combinazione di IVssBackupComponents::Query e IVssBackupComponents::GetSnapshotProperties per ottenere le proprietà del set specificato di copie shadow.

Le -qopzioni della riga di comando , -qxe -s si escludono a vicenda e non possono essere combinate con altre opzioni della riga di comando.

Eliminazione di copie shadow

vshadow** -da

vshadow -do

vshadow -dx=<ShadowCopySetId>

vshadow -ds=<ShadowCopyId>

Il -da comando elimina tutte le copie shadow nel computer.

Nota

L'opzione -da della riga di comando richiede la conferma dell'utente.

L'opzione -do della riga di comando elimina la copia shadow meno recente nel computer.

L'opzione -dx della riga di comando elimina tutte le copie shadow nel gruppo di copie shadow il cui ID è specificato da <ShadowCopySetId>.

L'opzione della riga di comando -ds elimina la copia ombra il cui ID è specificato da <ShadowCopyId>.

Queste opzioni della riga di comando sono utilizzabili solo con copie ombra persistenti. Le copie shadow non permanenti non devono essere eliminate in modo esplicito, perché vengono eliminate automaticamente quando il comando di creazione VShadow viene chiuso.

Le -daopzioni della riga di comando , -do-dx, e -ds si escludono a vicenda e non possono essere combinate con altre opzioni della riga di comando.

Interruzione di un set di copie shadow

vshadow -b=<ShadowCopySetId>

vshadow -bw=<ShadowCopySetId>

L'opzione -b=<ShadowCopySetId> della riga di comando converte ogni copia shadow nel set di copie shadow in un volume di sola lettura autonomo.

L'opzione -bw=<ShadowCopySetId> della riga di comando converte ogni copia shadow nel set di copie shadow in un volume scrivibile autonomo.

Nota

Le opzioni della -b riga di comando e -bw sono supportate solo nei sistemi operativi Windows Server.

Per informazioni sull'interruzione di un set di copie ombra, vedere Interruzione delle copie ombra.

Dopo l'interruzione del set di copie ombra, il set di copie ombra e le singole copie ombra non esistono più e non possono essere gestite utilizzando i comandi VSS.

Un set di copie shadow è persistente se è stato creato con il -p flag facoltativo. Se il set di copie shadow trasportabili non è persistente, viene visualizzato per un breve periodo di tempo durante l'esecuzione del comando di creazione della copia shadow e viene eliminato automaticamente al termine del comando. È possibile rompere insiemi di copie shadow non persistenti solo durante la creazione delle copie shadow, creando il set di copie shadow utilizzando il -exec flag facoltativo per eseguire un file CMD che chiama vshadow -b o vshadow -bw.

Le opzioni della -b riga di comando e -bw si escludono a vicenda e non possono essere combinate con altre opzioni della riga di comando.

Interruzione di un set di copie ombra tramite il metodo BreakSnapshotSetEx

vshadow -bex

L'opzione -bex della riga di comando interrompe un insieme di copie shadow in base alle opzioni specificate dai flag facoltativi -mask, -rw, -forcerevert, e -norevert. Questa opzione della riga di comando è simile alle opzioni della -b riga di comando e -bw . L'opzione -bex della riga di comando usa il metodo IVssBackupComponentsEx2::BreakSnapshotSetEx , mentre le opzioni della -b riga di comando e -bw usano il metodo IVssBackupComponents::BreakSnapshotSet .

Per informazioni sull'interruzione di un set di "copie shadow", vedere Interruzione delle "copie shadow".

Nota

L'opzione -bex della riga di comando è supportata solo nei sistemi operativi Windows Server.

vshadow -bex -mask

Il flag -mask specifica che il LUN della copia ombra verrà mascherato dall'host. Se il -mask flag viene specificato, non è possibile specificare i flag -rw, -forcerevert e -norevert.

vshadow -bex -rw

Il -rw flag specifica che il LUN della copia ombra verrà esposto all'host come volume di lettura e scrittura.

vshadow -bex -forcerevert

Il -forcerevert flag specifica che gli identificatori del disco di tutte le copie shadow dei LUN verranno riportati a quelli dei LUN originali. Tuttavia, se nel sistema sono presenti LUN originali, l'operazione fallirà e nessuno degli identificatori verrà ripristinato. Questo flag e il flag -norevert sono mutuamente esclusivi.

vshadow -bex -norevert

Il -norevert flag specifica che nessuno degli identificatori del disco LUN della copia shadow verrà ripristinato. Questa opzione e l'opzione -forcerevert si escludono a vicenda.

Esposizione di una copia ombra in locale

vshadow -el=<ShadowCopyId>,<LocalEmptyDirectory>

vshadow -el=<ShadowCopyId>,<UnusedDriveLetter>

L'opzione -el della riga di comando assegna una cartella montata o una lettera di unità a una copia shadow persistente. Si noti che il contenuto del volume rimarrà di sola lettura a meno che non si chiami successivamente vshadow -bw per interrompere il set di copie shadow.

Nota

Le copie ombra non permanenti e le copie ombra accessibili ai clienti non possono essere visualizzate localmente.

Ad esempio, se {bbbbcccc-1111-dddd-2222-eeee3333ffff} è il GUID di una copia ombra persistente esistente e X: è una lettera di unità inutilizzata, il comando seguente rende la copia ombra accessibile in X::

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

Nell'esempio seguente viene mostrato come esporre la stessa copia ombra nella cartella C:\ShadowCopies\June23 montata:

mkdir c:\ShadowCopies\June23

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

L'opzione -el della riga di comando non può essere combinata con altre opzioni della riga di comando.

Esposizione remota di una copia ombra

vshadow -er=<ShadowCopyId>,<UnusedShareName>

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

L'opzione -er della riga di comando assegna un nome di condivisione in sola lettura alla directory principale (o a una sottodirectory) dalla copia ombra. Si noti che il contenuto della condivisione rimarrà di sola lettura, a meno che successivamente non si chiami vshadow -bw per interrompere il set di copie ombra.

Nota

Le copie shadow accessibili dal client non possono essere esposte in remoto.

Ad esempio, se {bbbbcccc-1111-dddd-2222-eeee3333ffff} è il GUID di una copia shadow persistente esistente e share_123 è un nome di condivisione inutilizzato, il comando seguente espone la copia shadow in share_123:

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

Nell'esempio seguente viene illustrato come esporre solo un sottoalbero (denominato Folder1\Folder2) della stessa copia shadow nella stessa condivisione:

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

L'opzione -er della riga di comando non può essere combinata con altre opzioni della riga di comando.

Elenco dello stato e dei metadati dell'autore

vshadow -ws

vshadow -wm

vshadow -wm2

vshadow -wm3

L'opzione -ws della riga di comando enumera i VSS Writer attualmente in esecuzione sul computer e ne descrive lo stato. Questo comando è l'equivalente del comando Vssadmin list writers. Sono disponibili sei valori di stato possibili: Stable, Failed, UnknownWaiting for freeze, , Frozene Waiting for completion.

L'opzione -wm della riga di comando elenca un riepilogo dei metadati del writer, inclusi i volumi interessati.

L'opzione -wm2 della riga di comando elenca tutti i metadati del writer.

L'opzione -wm3 della riga di comando elenca tutti i metadati del writer in formato XML non elaborato.

Windows Vista e Windows Server 2003: l'opzione -wm3 della riga di comando non è supportata.

È possibile utilizzare queste informazioni per determinare quali volumi includere nel set di copie ombra del volume.

Nota

Se lo stato del writer è Stabile o In attesa di completamento, il writer può essere considerato in uno stato stabile, pronto per il backup successivo.

Le -wsopzioni della riga di comando , -wm-wm2, e -wm3 si escludono a vicenda e non possono essere combinate con altre opzioni della riga di comando.

Esecuzione di operazioni di ripristino

vshadow [OptionalFlags] -r=File.xml

vshadow [OptionalFlags] -rs=File.xml

L'opzione -r della riga di comando esegue un'operazione di ripristino.

L'opzione -rs della riga di comando esegue un'operazione di ripristino simulato.

Il file File.xml deve essere un documento dei componenti di backup per un set di copia shadow creato con il flag -t o opzionale -bc.

Le opzioni della -r riga di comando e -rs si escludono a vicenda e non possono essere combinate con altre opzioni della riga di comando.

OptionalFlags è una maschera di bit di valori di indicatori facoltativi della tabella seguente.

Valore indicatore facoltativo	Descrizione
-wi=<Writer>	Questo flag facoltativo verifica che il writer o il componente specificato sia incluso nel ripristino. <Writer> può specificare un percorso del componente, il nome dello scrittore, l'ID dello scrittore o l'ID istanza dello scrittore.
-wx=<Writer>	Questo flag opzionale verifica che lo scrittore o il componente specificato sia escluso dal ripristino. <Writer> può specificare un percorso del componente, il nome del writer, l'ID del writer o l'ID istanza del writer.
-exec=<Command>	Questo flag facoltativo esegue un comando o uno script tra gli eventi di prima del ripristino e dopo il ripristino inviati ai writer. <Command> può specificare un comando della shell eseguibile o un file CMD. Se specifica un comando della shell, non è possibile specificare parametri di comando.
-tracing	Questo flag opzionale genera un output dettagliato che può essere utilizzato per la verifica dei problemi.

Ripristino di una copia shadow precedente

vshadow -revert=<ShadowCopyId>

Nota

Questa opzione della riga di comando è supportata solo nei sistemi operativi Windows Server.

Windows Server 2008 e Windows Server 2003: non supportato.

L'opzione -revert della riga di comando ripristina un volume alla copia di backup precedente il cui ID è specificato da <ShadowCopyId>.

L'opzione -revert della riga di comando non può essere combinata con altre opzioni della riga di comando.

Risincronizzazione dei LUN

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

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

L'opzione -addresync della riga di comando specifica i volumi da includere in un'operazione di risincronizzazione LUN. Il parametro <ShadowCopyId> specifica l'ID della copia temporanea. Per copiare il contenuto del volume di copia ombra, il parametro facoltativo <TargetVolumeDriveLetter> specifica il volume di destinazione.

L'opzione -resync della riga di comando avvia un'operazione di risincronizzazione LUN. Al termine dell'operazione, la firma di ogni LUN di destinazione deve essere identica a quella del LUN del volume di destinazione. Il <BCDFileName> parametro specifica il nome del file XML che contiene il documento componente di backup.

Nota

Le opzioni della -addresync riga di comando e -resync sono supportate solo nei sistemi operativi Windows Server.

Windows Server 2008 e Windows Server 2003: non supportato.

OptionalResyncFlags è una maschera di bit di valori di flag facoltativi della tabella seguente.

Valore indicatore facoltativo	Descrizione
-revertsig	Questo flag facoltativo specifica che, dopo il completamento dell'operazione, la firma di ogni LUN di destinazione deve essere identica a quella del LUN originale utilizzato per creare la shadow copy, e non a quella del LUN del volume di destinazione. Nota: il -revertsig flag è supportato solo nei sistemi operativi Windows Server. Windows Server 2008 e Windows Server 2003: non supportato.
-novolcheck	Questo flag facoltativo specifica che il servizio VSS non deve controllare i volumi non selezionati che verrebbero sovrascritti dall'operazione di risincronizzazione LUN. Nota: il -novolcheck flag è supportato solo nei sistemi operativi Windows Server. Windows Server 2008 e Windows Server 2003: non supportato.

Vedi anche

Servizio Copia Shadow del Volume

Informazioni di riferimento sulle API Copia Shadow del volume