AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Start-EC2Instance-InstanceId <Object[]>-AdditionalInfo <String>-Select <String>-PassThru <SwitchParameter>-Force <SwitchParameter>-ClientConfig <AmazonEC2Config>Description
Starts an Amazon EBS-backed instance that you've previously stopped. Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the compute resources are released and you are not billed for instance usage. However, your root partition Amazon EBS volume remains and continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time. Every time you start your instance, Amazon EC2 charges a one-minute minimum for instance usage, and thereafter charges per second for instance usage. Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM. Performing this operation on an instance that uses an instance store as its root device returns an error. If you attempt to start a T3 instance withhost tenancy and theunlimited CPU credit option, the request fails. Theunlimited CPU credit option is not supported on Dedicated Hosts. Before you start the instance, either change its CPU credit option tostandard , or change its tenancy todefault ordedicated . For more information, see Stop and start Amazon EC2 instances in the Amazon EC2 User Guide.Parameters
-AdditionalInfo <String>Use the -Select parameter to control the cmdlet output. The default value is 'StartingInstances'. Specifying -Select '*' will result in the cmdlet returning the whole service response (Amazon.EC2.Model.StartInstancesResponse). Specifying the name of a property of type Amazon.EC2.Model.StartInstancesResponse will result in that property being returned. Specifying -Select '^ParameterName' will result in the cmdlet returning the selected cmdlet parameter value.
Required? False Position? Named Accept pipeline input? True (ByPropertyName) Common Credential and Region Parameters
-AccessKey <String>The session token if the access and secret keys are temporary session-based credentials.
Required? False Position? Named Accept pipeline input? True (ByPropertyName) Aliases ST Outputs
This cmdlet returns a collection of Amazon.EC2.Model.InstanceStateChange objects. The service call response (type Amazon.EC2.Model.StartInstancesResponse) can be returned by specifying '-Select *'.Examples
Example 1
Start-EC2Instance -InstanceId i-12345678
CurrentState InstanceId PreviousState
------------ ---------- -------------
Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceStateThis example starts the specified instance.Example 2
@("i-12345678", "i-76543210") | Start-EC2InstanceThis example starts the specified instances.Example 3
(Get-EC2Instance -Filter @{ Name="instance-state-name"; Values="stopped"}).Instances | Start-EC2InstanceThis example starts the set of instances that are currently stopped. The Instance objects returned by Get-EC2Instance are piped to Start-EC2Instance. The syntax used by this example requires PowerShell version 3 or higher.Example 4
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "instance-state-name"
$filter.Values = "stopped"
(Get-EC2Instance -Filter $filter).Instances | Start-EC2InstanceWith PowerShell version 2, you must use New-Object to create the filter for the Filter parameter.Related Links
Supported Version
AWS Tools for PowerShell: 2.x.y.z