vSphere PowerCLI Cmdlets Reference

Copy-DatastoreItem

Copies items between datastores and between a datastore and a local file system provider.

Syntax

Copy-DatastoreItem [-Item] <Object[]> [[-Destination] <Object>] [-Force] [-PassThru] [-Recurse] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Detailed Description

Copies items between datastores and between a datastore and a local file system provider.

Parameters

Name	Type	Description	Required?	Pipeline Input	Default Value
Item	Object[]	Specify the datastore item you want to copy. You can use a string to provide a relative path to the item in the current provider location.	true	true (ByValue)
Destination	Object	Specify the destination where you want to copy the datastore item. You can use a string to specify a relative path to the destination object in the current provider location.	false	false	.
Confirm	SwitchParameter	If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.	false	false	$true
Force	SwitchParameter	Indicate whether to overwrite all items with the same name at the provided destination.	false	false	$false
PassThru	SwitchParameter	Indicate that the cmdlet returns the copied item.	false	false	$false
Recurse	SwitchParameter	Indicate that you want to copy not only the item, but its children items as well.	false	false	$false
WhatIf	SwitchParameter	Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	false

Return Type

Notes

Supported only on servers that are ESX 3.5 and vCenter 2.5, and higher.

Examples

-------------- Example 1 --------------

Copy-DatastoreItem ds:\VM\* c:\VMFolder\VM\

Copies all items in the VM folder in the datastore provider locally to c:\VMFolder\VM\.

-------------- Example 2 --------------

Copy-DatastoreItem c:\VMFolder\NewVM\* ds:\VM\ -Force

Copies all files in the NewVM local folder to the VM folder in the datastore provider.