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