Share via


Win32_ShadowCopy class

The Win32_ShadowCopy class is a storage extent that represents a duplicate copy of the original volume at a previous time.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties and methods are in alphabetic order, not MOF order.

Syntax

class Win32_ShadowCopy : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  string   ID;
  datetime InstallDate;
  string   Name;
  string   SetID;
  string   ProviderID;
  string   Status;
  uint32   Count;
  string   DeviceObject;
  string   VolumeName;
  string   OriginatingMachine;
  string   ServiceMachine;
  string   ExposedName;
  uint32   State;
  boolean  Persistent;
  boolean  ClientAccessible;
  boolean  NoAutoRelease;
  boolean  NoWriters;
  boolean  Transportable;
  boolean  NotSurfaced;
  boolean  HardwareAssisted;
  boolean  Differential;
  boolean  Plex;
  boolean  Imported;
  boolean  ExposedRemotely;
  boolean  ExposedLocally;
};

Members

The Win32_ShadowCopy class has these types of members:

  • Methods
  • Properties

Methods

The Win32_ShadowCopy class has these methods.

Method Description
Create

Creates a shadow copy by using the specified context.

 

Properties

The Win32_ShadowCopy class has these properties.

Caption

Data type: string

Access type: Read-only

Short textual description of the object. This property is inherited from CIM_LogicalElement.

ClientAccessible

Data type: boolean

Access type: Read-only

If true, the shadow copy is created by the Windows Previous Versions component.

Count

Data type: uint32

Access type: Read-only

Number of shadow copies in a shadow copy set to which a shadow copy belongs.

Description

Data type: string

Access type: Read-only

Textual description of the object. This property is inherited from CIM_LogicalElement.

DeviceObject

Data type: string

Access type: Read-only

Windows object manager name for an underlying storage device that supports the original volume.

Differential

Data type: boolean

Access type: Read-only

If true, the shadow copy is created by a differential shadow copy provider. The provider can be implemented in hardware or software.

ExposedLocally

Data type: boolean

Access type: Read-only

If true, the shadow copy is exposed on the local computer with a drive letter or mount point. If ExposedLocally and ExposedRemotely are not set, the shadow copy is hidden.

ExposedName

Data type: string

Access type: Read-only

File system name of a shadow copy when it is exposed. The ExposedName property might contain a drive letter or mount point. The ExposedName property is NULL when a shadow copy is hidden or otherwise not exposed.

ExposedRemotely

Data type: boolean

Access type: Read-only

If true, the shadow copy is exposed on a remote computer with a network share. If ExposedRemotely and ExposedLocally are not set, the shadow copy is hidden.

HardwareAssisted

Data type: boolean

Access type: Read-only

If true, the shadow copy is created by a hardware shadow copy provider.

ID

Data type: string

Access type: Read-only

Unique identifier for a shadow copy on the system.

Imported

Data type: boolean

Access type: Read-only

If true, the shadow copy is imported to a computer by using the Import method and is not created by using the Create method.

InstallDate

Data type: datetime

Access type: Read-only

Date and time the object was installed. This property does not need a value to indicate that the object is installed. This property is inherited from CIM_LogicalElement.

Name

Data type: string

Access type: Read-only

Label by which the object is known. When subclassed, this property can be overridden to be a key property. This property is inherited from CIM_LogicalElement.

NoAutoRelease

Data type: boolean

Access type: Read-only

If true, the shadow copy is retained after the requestor process ends. If false, the shadow copy is automatically deleted when the requestor process ends.

NotSurfaced

Data type: boolean

Access type: Read-only

If true, the shadow copy is not currently in the device namespace of a local computer.

NoWriters

Data type: boolean

Access type: Read-only

If true, the shadow copy is created with the involvement of the shadow copy writer components.

OriginatingMachine

Data type: string

Access type: Read-only

Name of the computer that hosts the original volume.

Persistent

Data type: boolean

Access type: Read-only

If true, the shadow copy is persistent across reboots.

Plex

Data type: boolean

Access type: Read-only

If true, the shadow copy is created by a split mirror shadow copy provider. The provider can be implemented in hardware or software.

ProviderID

Data type: string

Access type: Read-only

Unique identifier for a shadow provider that creates a shadow.

ServiceMachine

Data type: string

Access type: Read-only

Name of the computer that services the shadow copy.

SetID

Data type: string

Access type: Read-only

Unique identifier for a shadow copy set to which the shadow belongs.

State

Data type: uint32

Access type: Read-only

Current state of a shadow copy.

Value Meaning
0

Unknown

1

Preparing

2

ProcessingPrepare

3

Prepared

4

ProcessingPrecommit

5

Precommitted

6

ProcessingCommit

7

Committed

8

ProcessingPostcommit

9

Created

10

Aborted

11

Deleted

12

Count

 

Status

Data type: string

Access type: Read-only

Current status of the object. This property is inherited from CIM_LogicalElement.

Values include the following:

"OK"

"Error"

"Degraded"

"Unknown"

"Pred Fail"

"Starting"

"Stopping"

"Service"

"Stressed"

"NonRecover"

"No Contact"

"Lost Comm"

Transportable

Data type: boolean

Access type: Read-only

If true, the shadow copy can be surfaced on another computer. If false, and the volumes are surfaced locally, it may not be possible to surface them later on a different computer.

VolumeName

Data type: string

Access type: Read-only

Name of the original volume for which a shadow copy is made.

Remarks

Note  This class is unavailable for 32-bit applications on Windows Server 2008 x64. To access the class with Visual Studio, go to Project Properties, then General, and un-check the Prefer 32-bit box.

 

Examples

The Get Remote Shadow Volume Information With Powershell PowerShell sample on TechNet gallery uses Win32_ShadowCopy to retrieve shadow volume information.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003

Namespace

Root\CIMV2

MOF

Vss.mof

DLL

Vsswmi.dll

See also

CIM_LogicalElement

Win32_ShadowProvider

Win32_ShadowContext

Win32_ShadowStorage

Win32_ShadowBy

Win32_ShadowFor

Win32_ShadowOn

Win32_ShadowVolumeSupport

Win32_ShadowDiffVolumeSupport