Export (0) Print
Expand All
Expand Minimize

Get-SCVMMManagedComputer

Updated: April 29, 2014

Applies To: System Center 2012 R2 Virtual Machine Manager

Get-SCVMMManagedComputer

Gets computer objects managed by VMM.

Syntax

Parameter Set: Default
Get-SCVMMManagedComputer [[-ComputerName] <String> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]




Detailed Description

The Get-SCVMMManagedComputer cmdlet gets one or more computer objects managed by Virtual Machine Manager (VMM). Managed computers include the following types of computers:

-- Virtual machine host. A Hyper-V host, VMware ESX host, or Citrix XenServer host on which you deploy virtual machines.
-- VMware virtualization manager. A server running VMware vCenter Server that VMM connects to in order to manage ESX hosts and the virtual machines deployed on those hosts.
-- Library server. A server used to make shares available to store VMM library resources.
-- P2V source computer. Any physical computer that you want to clone so that you can use its hardware and software settings to create one or more virtual machines.

Parameters

-ComputerName<String>

Specifies the name of a computer that VMM can uniquely identify on your network. Valid formats are:

-- FQDN
-- IPv4 or IPv6 address
-- NetBIOS name

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


Aliases

none

Required?

false

Position?

1

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.

  • VMMManagedComputer

Examples

Example 1: Get all computers managed by VMM

This command gets all computer objects managed by VMM, and then displays information about these managed computers to the user. When you look at the output, note that the RoleString property indicates whether the server is a library server, a host for virtual machines, both a library server and a host, a VMware vCenter Server, or a Citrix XenServer.


PS C:\> Get-SCVMMManagedComputer

Example 2: Update the agent software on all host servers managed by VMM

The first command uses Get-Credential to prompt you to supply a user name and password, and then stores your credentials in the $Credential variable. The required credential for this operation is a domain account with rights to update software on computers managed by VMM.

The second command gets all computer objects managed by VMM, and then passes each managed computer object to the Update-SCVMMManagedComputer cmdlet that updates the VMM agent software on each computer. As this command is processed, $Credential provides credentials to the Update-SCVMMManagedComputer cmdlet.


PS C:\> $Credential = Get-Credential
PS C:\> Get-SCVMMManagedComputer | Update-SCVMMManagedcomputer -Credential $Credential -RunAsynchronously

Example 3: Get a specific computer managed by VMM by IP address

This command gets a computer object by its IP address.


PS C:\> Get-SCVMMManagedComputer -ComputerName "10.20.30.40"

Related topics

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