This cmdlet is part of the Vexasoft Cmdlet Library. You can download it now or click here to find out more.

Start-Computer

Synopsis

Powers on a remote computer using Wake-On-LAN.

Syntax

  • Start-Computer [-MACAddress] [-Packets] [-Port]

Description

Start-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.

Parameters

  • 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.

Inputs

Start-Computer accepts the output of Get-NetworkAdapter as an input object, or any object with a MAC address or MAC parameter.

Outputs

Start-Computer does not output any PowerShell objects.

Notes

Start-Computer requires that the target computer is Wake-On-LAN enabled and that the network is configured to allow Wake-On-LAN functionality.

Example 1

This 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 2

This 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