Get-EmcVirtualMachineConfiguration

Gets the virtual machine configuration.

Syntax

• Get-EmcVirtualMachineConfiguration [[-ID] <String>] [[-Hypervisor] <IHypervisor>] [-Silent] [<CommonParameters>]

• Get-EmcVirtualMachineConfiguration [[-ID] <String>] [-VirtualMachine] <IHostSystem> [-Silent] [<CommonParameters>]

• Get-EmcVirtualMachineConfiguration [[-ID] <String>] [[-VcenterSystem] <IVcenterSystem>] [-Silent] [<CommonParameters>]

Parameters

-ID <String>

Attributes: Optional, Position: 1

Specifies the name of the virtual machine. Wildcards are permitted. It is a positional parameter (position = 1).

-VirtualMachine <IHostSystem>

Attributes: Required, Position: 1

Specifies the ESI virtual machine host system object, which is derived from the host system. A virtual machine can be added to ESI by using the Get-EmcHostSystemCredential and Connect-EmcSystem cmdlets, the same as the host system. A virtual machine (host system) object can be obtained by using the Get-EmcHostSystem cmdlet.

-Hypervisor <IHypervisor>

Attributes: Optional, Position: 1

Specifies the hypervisor object for the ESI virtual machine, which you can get by using the Get-EmcVirtualMachineHypervisor cmdlet.

-VirtualMachine <IHostSystem>

Attributes: Required, Position: 1

Specifies the ESI virtual machine host system object, which is derived from the host system. You can add a virtual machine to ESI using the Get-EmcHostSystemCredential and Connect-EmcSystem cmdlets. You can get a virtual machine host system object by using the Get-EmcHostSystem cmdlet.

-VcenterSystem <IVcenterSystem>

Attributes: Optional, Position: 1

Specifies the vCenter server.

-Silent <SwitchParameter>

Attributes: Optional, Position: named

Turns off all the informational and verbose messages. However, it still displays errors.

<CommonParameters>

This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.

Examples

-------------- Example 1 --------------

C:\PS>Get-EmcHostSystem | Update-EmcSystem -Silent

C:\PS>$vm = Get-EmcHostSystem *.148

C:\PS>$vm.model

Virtual Machine

C:\PS>$vmconfig = $vm | Get-EmcVirtualMachineConfiguration

C:\PS>$vmconfig.status

Running

C:\PS>$vmconfig.vmid.guid

C4908C4C-6564-4688-B8EC-E47E7758E17E

C:\PS>$vmconfig.FileBasedVmScsiDiskConfigs[0].Descriptor.Source

E:\ps_test1.vhd

This example gets the virtual machine configuration.

-------------- Example 2 --------------

C:\PS>$hyperv = Get-EmcHyperVSystem | Connect-EmcSystem

C:\PS>$hyperv | Update-EmcSystem -Silent

C:\PS>Get-EmcVirtualMachineConfiguration -Hypervisor $hyperv

This example gets the virtual machine configurations of all of the virtual machines on a Hyper-V hypervisor.

-------------- Example 3 --------------

C:\PS>$vcenter = Get-EmcVcenterSystem

C:\PS>$vcenter | Update-EmcSystem -Silent

C:\PS>Get-EmcVirtualMachineConfiguration -VcenterSystem $vcenter

This example gets the virtual machine configurations of all of the virtual machines on vSphere hypervisor.