Share via


Get-DfsrCloneState

Get-DfsrCloneState

Gets the status of a database cloning operation.

Syntaxe

Get-DfsrCloneState [ <CommonParameters>]

Description détaillée

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.

Paramètres

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

  • [none]

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

  • DfsrCloneState

Exemples

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

Rubriques connexes

Import-DfsrClone

Export-DfsrClone

Reset-DfsrCloneState