Get-DfsrCloneState

Get-DfsrCloneState

Gets the status of a database cloning operation.

Syntax

Get-DfsrCloneState [ <CommonParameters>]

Detailed Description

The Get-DfsrCloneState cmdlet gets the status of an ongoing cloning operation for a volume from the local computer. The cmdlet returns the state of exporting or importing configuration XML file settings for a DFS Replication database or volume.

This cmdlet does not have any parameters and returns only state information. You must run this cmdlet on the DFS Replication computer that performs the export or import. Only one import or export can run at a time on a server.

The DFS Replication service can return the following cloning states:

-- Ready. The DFS Replication service is ready to perform cloning. This is the status both before cloning starts and after cloning completes.

-- Started DB Export. The DFS Replication service has begun the export process and is validating prerequisites.

-- Started DB Import. The DFS Replication service has begun the import process and is validating prerequisites.

-- Processing DB Export. The DFS Replication service is exporting the database.

-- Processing DB Import. The DFS Replication service is importing the database.

-- Resetting. The DFS Replication service is cancelling and rolling back the import or export.

-- Shut down. The DFS Replication database is shut down due to a requested backup or restore operation.

-- Shutting down. The DFS Replication database is shutting down because of a requested backup or restore operation, or because of a requested service shut down.

Parameters

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

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

  • [none]

Outputs

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

  • DfsrCloneState

Examples

Example 1: Get the state of DFS Replication cloning

This command gets the state of DFS Replication cloning. In this case the server is not currently cloning; either the cloning operation has not started or has finished.

PS C:\> Get-DfsrCloneState

Example 2: Get the state during a cloning operation

This example exports a DFS Replication database clone and gets the status of the ongoing cloning operation. The first command runs in one Windows PowerShell console, and the remaining commands run in a second Windows PowerShell console. This is required because the Export-DfsrClone cmdlet does not return until the DFS Replication service completes the export or if you press Ctrl + C to exit the cmdlet.

The first command exports a cloned DFS Replication database and volume configuration settings from C:\dfsrclone.

PS C:\> Export-DfsrClone -Volume C: -Path C:\dfsrclone -Force

The second command returns the state that indicates that the DFSR service has begun the export process and is validating prerequisites.

PS C:\> Get-DfsrCloneState

The third command returns the state that indicates that the DFS Replication service is exporting the database.

PS C:\> Get-DfsrCloneState

The fourth command returns the state that indicates that the cloning is complete and the DFS Replication service is ready to perform cloning.

PS C:\> Get-DfsrCloneState

Import-DfsrClone

Export-DfsrClone

Reset-DfsrCloneState