New-SCComputerConfiguration

New-SCComputerConfiguration

Creates a computer configuration object by gathering computer configuration information from a physical source machine that you plan to convert to a virtual machine managed by VMM.

Syntax

Parameter Set: Default
New-SCComputerConfiguration -Credential <PSCredential> -SourceComputerName <String> [-JobVariable <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The New-SCComputerConfiguration cmdlet creates a computer configuration object by gathering computer configuration information from a physical machine that you plan to convert to a virtual machine managed by Virtual Machine Manager (VMM). Information about a computer's hardware, physical disks, and operating system is stored in the machine configuration object.

New-SCComputerConfiguration installs the VMM P2V agent software on the physical source machine, runs the configuration information gathering process, and creates and stores the resulting machine configuration object (which is associated with this physical source computer) in the VMM database.

A computer configuration is used when you use the New-SCP2V cmdlet to convert a physical machine to a virtual machine. To perform this conversion, you use a physical computer as a model from which to create an identical, or nearly identical, virtual machine that has the same identity (ComputerName.DomainName) as the physical machine.

For information about the operating systems for which VMM supports P2V, see "Converting Physical Computers to Virtual Machines in VMM" in the TechNet Library at https://go.microsoft.com/fwlink/?LinkId=225101.

Parameters

-Credential<PSCredential>

Specifies a credential object or, for some cmdlets, a Run As account object that contains the user name and password of an account that has permission to perform this action. Or, in the case of Restart-SCJob, has permission to complete a restarted task.

For more information about the PSCredential object, type: "Get-Help Get-Credential".

For more information about Run As accounts, type: "Get-Help New-SCRunAsAccount".

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

-PROTipID<Guid>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

-SourceComputerName<String>

Specifies the source computer for a physical-to-virtual (P2V) machine conversion performed by VMM. Valid formats: FQDN, IPv4 or IPv6 address, or NetBIOS name.

Note: See the examples for a specific cmdlet to determine how that cmdlet specifies the source computer name.

-VMMServer<ServerConnection>

Specifies a VMM server object.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

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.

• VMConfiguration

Examples

1: Gather information from a physical source machine.

The first command uses Get-Credential to prompt you to supply a user name and password and stores your credentials in the $Credential variable. The required credentials for this operation are either a local Administrator account or a domain account with administrator rights on the computer from which you want to gather information.

The second gathers the computer configuration information from the physical source machine called P2VSource01 in the Contoso.com domain. As this command is processed, $Credential provides your credentials to New-SCComputerConfiguration. The New-ComputerConfiguration cmdlet stores the resulting machine configuration object associated with P2VSource01.Contoso.com in the VMM database.

PS C:\> $Credential = Get-Credential
PS C:\> New-SCComputerConfiguration -SourceComputerName "P2VSource01.Contoso.com" -Credential $Credential

2: Determine the required patches for a particular conversion.

The first command uses Get-Credential to prompt you to supply a user name and password and stores your credentials in the $Credential variable. The required credentials for this operation are either a local Administrator account or a domain account with administrator rights on the computer from which you want to gather information.

The second gathers the computer configuration information from the physical source machine named P2VSource02 in the Contoso.com domain, and it stores the information in $ComputerConfig. As this command is processed, $Credential provides your credentials to New-SCComputerConfiguration.

The last command displays the list of errors, if any, that were detected on the source machine. Any items with the value 'Error' must be resolved before you attempt a physical-to-virtual conversion.

PS C:\> $Credential = Get-Credential
PS C:\> $ComputerConfig = New-SCComputerConfiguration -SourceComputerName "P2VSource02.Contoso.com" -Credential $Credential
PS C:\> $ComputerConfig.ErrorList

Related topics

Add-SCPatch

Get-SCComputerConfiguration

New-SCP2V

Remove-SCComputerConfiguration