SynopsisPowers on a remote computer using Wake-On-LAN.
- Start-Computer [-MACAddress] [-Packets] [-Port]
DescriptionStart-Computer is used to send Wake-On-LAN magic packets to a remote computer. It requires that the remote computer is Wake-On-LAN enabled and that the network is configured to all Wake-On-LAN functionality.
- MACAddress The MAC Address of a Wake-On-LAN enabled network adapter on the target computer.
- Packets The number of magic packets to send to the target MAC address. If this parameter is not specified a default of 3 packets are sent.
- Port The port on which to send the magic packet. If not specified this cmdlet will use the default Wake-On-LAN port 9.
InputsStart-Computer accepts the output of Get-NetworkAdapter as an input object, or any object with a MAC address or MAC parameter.
OutputsStart-Computer does not output any PowerShell objects.
NotesStart-Computer requires that the target computer is Wake-On-LAN enabled and that the network is configured to allow Wake-On-LAN functionality.
Example 1This command will attempt to power on the computer with MAC address 00-21-EE-11-DF-C1. Because the Packets and Port parameters have not been set, a total of three packets will be sent on port 9:
Start-Computer -MACAddress 00-21-EE-11-DF-C1
Example 2This command will attempt to power on the computer with MAC address 00-21-EE-11-DF-C1 by sending 6 magic packets on port 29:
Start-Computer -MACAddress 00-21-EE-11-DF-C1 -Port 29 -Packets 6