New-SCVMXComputerConfiguration

New-SCVMXComputerConfiguration

Creates a VMX computer configuration object by gathering virtual machine configuration information from a virtual machine created in VMware that you plan to convert to a virtual machine deployed on a Windows-based host managed by VMM.

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: \\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

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 stores the object in the $LibServ variable.

The last 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.

NOTE: 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"

Add-SCPatch

Copy-SCVirtualHardDisk

Get-SCVMXComputerConfiguration

New-SCV2V

Remove-SCVMXComputerConfiguration