New-SCVMXComputerConfiguration
New-SCVMXComputerConfiguration
Creates a VMX computer configuration object.
Syntax
Parameter Set: Default
New-SCVMXComputerConfiguration [-VMXPath] <String> [-JobVariable <String> ] [-LibraryServer <LibraryServer> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Detailed Description
The New-SCVMXComputerConfiguration cmdlet creates a VMX computer configuration object by gathering information about the physical characteristics of a VMware-based virtual machine and its disks that you plan to convert to a virtual machine deployed on a Windows-based Hyper-V host managed by Virtual Machine Manager (VMM). This cmdlet does not collect information about the operating system or data on the VMware-based virtual machine.
VMWare virtual hard disk formats supported by the New-SCVMXComputerConfiguration cmdlet include:
-- monolithicSparse
-- monolithicFlat
-- vmfs
-- twoGbMaxExtentSparse
-- twoGbMaxExtentFlat
Parameters
-JobVariable<String>
Specifies that job progress is tracked and stored in the variable named by this parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-LibraryServer<LibraryServer>
Specifies a VMM library server object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PROTipID<Guid]>
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
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 |
-VMXPath<String>
Specifies the full UNC path to the .vmx file of a VMware virtual machine.
Example format: -VMXPath "\\ServerName\VolumeName\DirectoryName\VMwareVM.vmx"
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
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.
- VMXMachineConfig
Examples
Example 1: Gather information from a VMware-based virtual machine
The first command gets the library server object named LibServer01 in the Contoso.com domain, and then stores the object in the $LibServ variable.
The second command gathers the machine configuration information for the .vmx file located at \\FileServer01\MSSCVMMLibrary\VMware\VMSource.vmx on the library server. The New-SCVMXComputerConfiguration cmdlet stores the resulting VMX computer configuration object associated with VMSource.vmx in the VMM database.
If you look in Library view in the VMM console, you cannot see the file VMSource.vmx file because the .vmx file is part of a single virtual machine object. What you see in Library view is the virtual machine. To find the path to a .vmdk file, view the properties for that virtual machine.
PS C:\> $LibServ = Get-SCLibraryServer -ComputerName "LibServer01.Contoso.com"
PS C:\> New-SCVMXComputerConfiguration -LibraryServer $LibServ -VMXPath "\\FileServer01\MSSCVMMLibrary\VMware\VMSource.vmx"
Related topics
Add-SCPatch
Get-SCVMXComputerConfiguration