Data ONTAP® PowerShell Toolkit

Switch to clustered Data ONTAP documentation.

Cmdlet: Copy-NaHostFile


NAME
Copy-NaHostFile

SYNOPSIS
Copy a file between LUNs mounted on a Windows host, or within a LUN mounted
on a windows host.

SYNTAX
Copy-NaHostFile [-SourceFile] <String> [-DestinationFile] <String> [-Verify]
[-Controller <AbstractController>] [<CommonParameters>]


DESCRIPTION
Copy a file between LUNs mounted on a Windows host, or within a LUN mounted
on a windows host.

The source and destination files must reside on LUNs contained in the same v
olume. The destination file must not already exist. If the controller supp
lied in the Controller parameter is not the controller containing the LUNs,
the cmdlet consults the credentials cache and attempts to connect via HTTPS.
If credentials are not present in the credentials cache, an attempt to con
nect via RPC is made. If a connection cannot be made, the cmdlet will fail.

The source and destination files must be specified with a fully-qualified pa
th that resides on a Data ONTAP LUN. Cluster-shared volumes (CSVs) are supp
orted. Administrator privileges are required to use this cmdlet.


PARAMETERS
-SourceFile <String>
Full path to the source file.

Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false

-DestinationFile <String>
Full path to the destination file.

Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Verify
If specified, a warning will be emitted if the MD5 hash of the source an
d destination files are not the same.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <AbstractController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
System.IO.FileInfo


NOTES


Category: host
API: clone-start

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

C:\PS>Copy-NaHostFile H:\VM1.vhd I:\VM1_copy.vhd


Copy the VHD file H:\VM1.vhd to I:\VM1_copy.vhd.


Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 8/16/2011 10:41 AM 3221221888 VM1_copy.vhd



RELATED LINKS







 Data ONTAP® PowerShell Toolkit