Copy-DatastoreItem

Syntax

• Default

Copy-DatastoreItem

-Item  <Object[]>
[[-Destination]  <Object>]
[-Force]
[-PassThru]
[-Recurse]
[CommonParameters]

---

Parameters

Required	Parameter Name	Type	Position	Features	Description
required	Item	Object[]	named	wildcards pipeline	Specifies 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. For more information about the PowerCLI datastore provider, run "Get-Help about_vimdatastore".
optional	Destination	Object	1		Specifies 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. For more information about the PowerCLI datastore provider, run "Get-Help about_vimdatastore".
optional	Force	SwitchParameter	named		Indicates whether to overwrite all items with the same name at the provided destination.
optional	PassThru	SwitchParameter	named		Indicates that the cmdlet returns the copied item.
optional	Recurse	SwitchParameter	named		Indicates that you want to copy not only the item, but its children items as well.

Output

System.IO.FileInfo

Examples

---

Example 1

Copy-DatastoreItem vmstore:\Datacenter\Storage1\MyVM\* c:\VMFolder\MyVM\

Copies the contents of a datastore folder in a local folder.

Example 2

Copy-DatastoreItem c:\VMFolder\MyVM\* vmstore:\Datacenter\Storage1\NewVM\ -Force

Copies the contents of a local folder into a datastore folder. If the destination folder does not exist, the Force parameter enforces its creation.

Example 3

Copy-DatastoreItem c:\VMFolder\* vmstore:\Datacenter\Storage1\VMs\ -Force -Recurse

Copies recursively the contents of a local folder into a datastore folder.

Example 4

Copy-DatastoreItem Windows.ISO vmstore:\Datacenter\Storage1\ISOFiles\WinXPSP3.iso

Copies a file into a datastore folder and changes the file name.

Related Commands