New-InstantCloneClone

Creates a new clone database from an Instant Clone snapshot.

Syntax

Description

The new clone is a normal SQL Server database backed by a virtual differencing-disk, which references the snapshot file. A clone takes a few seconds to create and occupies roughly 30mb initially. As the database is used, the clone will grow to the size of the diff with the original.

Parameters

-NewDatabaseName <System.String>

The clone's name. This name is used as the name of new database.

-SnapshotName <System.String>

Name of snapshot to clone from. If multiple snapshots with that name are available, the most recent one is used. To specify a specific snapshot, use the SnapshotId parameter.

-SnapshotId <System.String>

The ID of the snapshot to clone from. You may find this useful if there are multiple snapshots with the same name.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see http://technet.microsoft.com/en-us/library/hh847884.aspx.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

• None.
  You cannot pipe input to this cmdlet.

Return values

The output type is the type of the objects that the cmdlet emits.

• None.
  You cannot pipe input to this cmdlet.

Examples

---------- EXAMPLE 1 ----------

New-InstantCloneClone -NewDatabaseName AdvClone1 -SnapshotName AdvSnap -Verbose
New-InstantCloneClone -NewDatabaseName AdvClone2 -SnapshotName AdvSnap -Verbose

This example demonstrates creating two clone databases, AdvClone1 and AdvClone2, from the snapshot AdvSnap.

Create AdvSnap with the Save-InstantCloneSnapshot cmdlet.

Use the -Verbose switch to provide more detailed feedback during clone creation.