Win32_ShadowCopy

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

Quick Start

Properties

In this WMI class, all WMI properties are read-only. You can only read values but not change them.

Caption

Data type String

The Caption property is a short textual description (one-line string) of the object.

ClientAccessible

Data type Boolean

The ClientAccessible property is indicates whether the shadow copy was created by the Windows Previous Versions component.

Count

Data type UInt32

The Count property is the number of shadow copies in the shadow copy set to which this shadow copy belongs.

Description

Data type String

The Description property provides a textual description of the object.

DeviceObject

Data type String

The DeviceObject property is the Windows object manager name of the underlying storage device that supports the original volume.

Differential

Data type Boolean

The Differential property indicates whether the shadow copy was created by a differential shadow copy provider. The provider can be implemented in hardware or software.

ExposedLocally

Data type Boolean

The ExposedLocally property indicates whether the shadow copy is exposed on the local machine with a drive letter or mount point. If this flag and the ExposedRemotely flag is not set, the shadow copy is hidden.

ExposedName

Data type String

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

ExposedPath

Data type String

The ExposedPath property is the file system path of the shadow copy when it is exposed. This property is NULL when the shadow copy is hidden or otherwise unexposed.

ExposedRemotely

Data type Boolean

The ExposedRemotely property indicates whether the shadow copy is exposed on a remote machine with a network share. If this flag and the ExposedLocally flag is not set, the shadow copy is hidden.

HardwareAssisted

Data type Boolean

The HardwareAssisted property indicates whether the shadow copy was created by a hardware shadow copy provider.

ID

Data type String

The ID property uniquely identifies the shadow copy on the system.

Imported

Data type Boolean

The Imported property indicates whether the shadow copy was imported onto this machine using the Import method rather than created using the ShadowCopy create method.

InstallDate

Data type DateTime

The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.

Name

Data type String

The Name property defines the label by which the object is known. When subclassed, the Name property can be overridden to be a Key property.

NoAutoRelease

Data type Boolean

The NoAutoRelease property indicates whether the shadow copy is automatically deleted when the shadow copy requestor process ends. If this property is $true, the shadow copy is retained after the requestor process ends.

NotSurfaced

Data type Boolean

The shadow copy is not currently in the device namespace of the local machine.

NoWriters

Data type Boolean

The NoWriters property indicates whether the shadow copy was created with the involvement of shadow copy writer components.

Option

Data type UInt32

OriginatingMachine

Data type String

The OriginatingMachine property identifies the machine hosting the original volume.

Persistent

Data type Boolean

The Persistent property indicates whether the shadow copy is persistent across reboots.

Plex

Data type Boolean

The Plex property indicates whether the shadow copy was created by a split mirror shadow copy provider. The provider can be implemented in hardware or software.

ProviderID

Data type String

The ProviderID uniquely identifies the shadow provider that created the shadow.

Recursive

Data type Boolean

SecurityDescriptor

Data type Object

ServiceMachine

Data type String

The ServiceMachine property identifies the machine currently servicing the shadow copy.

SetID

Data type String

The SetID uniquely identifies the shadow copy set to which the shadow belongs.

StartFileName

Data type String

State

Data type UInt32

The State property describes the current state of the shadow copy

$State_ReturnValue = 
@{
    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

The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are “OK”, “Degraded” and “Pred Fail”. “Pred Fail” indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are “Error”, “Starting”, “Stopping” and “Service”. The latter, “Service”, could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither “OK” nor in one of the other states.

'OK','Error','Degraded','Unknown','Pred Fail','Starting','Stopping','Service','Stressed','NonRecover','No Contact','Lost Comm'

Transportable

Data type Boolean

The Transportable property indicates whether the shadow copy can be surfaced on another machine. If this property is $false and the volumes are surfaced locally, it may not be possible to surface them later on a different machine.

VolumeName

Data type String

The VolumeName property identifies the original volume for which the shadow copy was taken.

Methods

Examples

See Also

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

Content last updated: 2013-12-27 12:22:21 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin