Get-SCVMMManagedComputer
Applies To: System Center 2012 - 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 System Center 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.
For more information about Get-SCVMMManagedComputer, type: "Get-Help Get-SCVMMManagedComputer -online".
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, or 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
1: Get all computers managed by VMM.
This command gets all computer objects managed by VMM and 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
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 credentials 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 which 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
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"