Export-SCLibraryPhysicalResource
Export-SCLibraryPhysicalResource
Exports a library resource form a VMM library share to a local file folder or network share.
Syntax
Parameter Set: Default
Export-SCLibraryPhysicalResource [-Path] <String> -Resource <ItemBase> [-AllowUnencryptedTransfer] [-OverwriteExistingFiles] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Detailed Description
The Export-SCLibraryPhysicalResource exports (copies) a library resource from a Virtual Machine Manager (VMM) library share to a local file folder or network share.
Parameters
-AllowUnencryptedTransfer
Indicates that network file transfers do not require encryption. Allowing unencrypted network file transfers can improve performance if neither the source host nor the destination host requires encryption.
Use this parameter to:
- Allow unencrypted file transfers into, or out of, the library.
- Allow unencrypted file transfers into, out of, or within a host group.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-OverwriteExistingFiles
Indicates that files with the same name are overwritten when importing or exporting resources into or out of the VMM library.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Path<String>
Specifies the destination path for the operation.
Example formats:
Local path -Path "F:\"
UNC path -Path "\\Library\Templates"
Volume GUID path -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
VMware ESX path –Path "[storage1]\MyVMwareFolderForVMs\MyVM.vmx"
Citrix XenServer path - Path “Local storage[99b6212f-b63d-c676-25f9-d6c460992de7]”
Wildcards are supported for "Get" cmdlets and when you specify the UNC path:
Example format:
UNC path -Path "\\VMHostServer\MyVMs\*VM*"
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Resource<ItemBase>
Specifies a resource object.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-VMMServer<ServerConnection>
Specifies a VMM server object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
<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.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
1. Export a specific library resource to a local file folder.
The first command gets the virtual hard disk object named VHD01 and stores the object in the $Resource variable.
The second command exports the resource stored in $Resource to the folder named C:\ExportedLibResources. If the resource had been previously exported to this folder, this command would overwrite any of those files.
PS C:\> $Resource = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> Export-SCLibraryPhysicalResource -Resource $Resource -Path "C:\ExportedLibResources" -OverwriteExistingFiles
2. Export a library resource to a network share.
The first command gets the application package object named WebApp01.zip and stores the object in the $Resource variable.
The second command exports the library resource stored in $Resource to the network share named \\FileShare01\LibExports.
PS C:\> $Resource = Get-SCApplicationPackage -Name "WebApp01.zip"
PS C:\> Export-SCLibraryPhysicalResource -Resource $Resource -Path "\\FileShare01\LibExports"