Get-SCVMMManagedComputer
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
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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. 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
New-SCP2V