Export (0) Print
Expand All
Expand Minimize

New-SCComputerConfiguration

Updated: September 27, 2012

Applies To: System Center 2012 - Virtual Machine Manager

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 System Center 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 http://go.microsoft.com/fwlink/?LinkId=225101.

For more information about New-SCComputerConfiguration, type: "Get-Help New-SCComputerConfiguration -online".

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".


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-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

-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

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


Aliases

none

Required?

true

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

<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-CredentialPS 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-CredentialPS C:\> $ComputerConfig = New-SCComputerConfiguration -SourceComputerName "P2VSource02.Contoso.com" -Credential $CredentialPS C:\> $ComputerConfig.ErrorList

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft