Herramientas de AWS para PowerShell La V4 ha entrado en modo de mantenimiento.
Le recomendamos que migre a la [Herramientas de AWS para PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/). Para obtener información y detalles adicionales sobre cómo realizar la migración, consulta nuestro [anuncio sobre el modo de mantenimiento](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Lanzamiento de una instancia de Amazon EC2 con Windows PowerShell
Para lanzar una instancia Amazon EC2, necesita el par de claves y el grupo de seguridad que ha creado en las secciones anteriores. También necesita el ID de una imagen de máquina de Amazon (AMI). Para obtener más información, consulte la documentación siguiente:
+ [Creación de un par de claves](pstools-ec2-keypairs.md)
+ [Creación de un grupo de seguridad mediante Windows PowerShell](pstools-ec2-sg.md)
+ [Buscar una imagen de máquina de Amazon mediante Windows PowerShell](pstools-ec2-get-amis.md)
**importante**
Si lanza una instancia que no figura en la capa gratuita, se le facturará en cuanto la lance y se le cobrará el tiempo en que la instancia esté funcionando, aunque permanezca inactiva.
**Topics**
+ [Lanzamiento de una instancia en una VPC](#new-ec2instance-vpc)
+ [Lanzamiento de una instancia de subasta en una VPC](#new-ec2instance-spot)
## Lanzamiento de una instancia en una VPC
**aviso**
EC2-Classic se retirará el 15 de agosto de 2022. Le recomendamos que migre de EC2-Classic a una VPC. Para obtener más información, consulte la entrada del blog [EC2-Classic Networking is Retiring – Here's How to Prepare](https://aws.amazon.com/blogs/aws/ec2-classic-is-retiring-heres-how-to-prepare/).
El siguiente comando crea una sola instancia `m1.small` en la subred privada especificada. El grupo de seguridad debe ser válido para la subred especificada.
```
PS > New-EC2Instance `
-ImageId ami-c49c0dac `
-MinCount 1 -MaxCount 1 `
-KeyName myPSKeyPair `
-SecurityGroupId sg-5d293231 `
-InstanceType m1.small `
-SubnetId subnet-d60013bf
ReservationId : r-b70a0ef1
OwnerId : 123456789012
RequesterId :
Groups : {}
GroupName : {}
Instances : {}
```
Al principio, la instancia tiene el estado `pending`, pero cambia al estado `running` en unos minutos. Para ver información sobre la instancia, use el cmdlet `Get-EC2Instance`. Si tiene varias instancias, puede filtrar los resultados por ID de reserva mediante el parámetro `Filter`. En primer lugar, cree un objeto de tipo `Amazon.EC2.Model.Filter`. A continuación, llame a `Get-EC2Instance` que utiliza el filtro y, a continuación, muestra la propiedad `Instances`.
```
PS > $reservation = New-Object 'collections.generic.list[string]'
PS > $reservation.add("r-b70a0ef1")
PS > $filter_reservation = New-Object Amazon.EC2.Model.Filter -Property @{Name = "reservation-id"; Values = $reservation}
PS > (Get-EC2Instance -Filter $filter_reservation).Instances
AmiLaunchIndex : 0
Architecture : x86_64
BlockDeviceMappings : {/dev/sda1}
ClientToken :
EbsOptimized : False
Hypervisor : xen
IamInstanceProfile :
ImageId : ami-c49c0dac
InstanceId : i-5203422c
InstanceLifecycle :
InstanceType : m1.small
KernelId :
KeyName : myPSKeyPair
LaunchTime : 12/2/2018 3:38:52 PM
Monitoring : Amazon.EC2.Model.Monitoring
NetworkInterfaces : {}
Placement : Amazon.EC2.Model.Placement
Platform : Windows
PrivateDnsName :
PrivateIpAddress : 10.25.1.11
ProductCodes : {}
PublicDnsName :
PublicIpAddress : 198.51.100.245
RamdiskId :
RootDeviceName : /dev/sda1
RootDeviceType : ebs
SecurityGroups : {myPSSecurityGroup}
SourceDestCheck : True
SpotInstanceRequestId :
SriovNetSupport :
State : Amazon.EC2.Model.InstanceState
StateReason :
StateTransitionReason :
SubnetId : subnet-d60013bf
Tags : {}
VirtualizationType : hvm
VpcId : vpc-a01106c2
```
## Lanzamiento de una instancia de subasta en una VPC
El script de ejemplo siguiente solicita una instancia de spot en la subred especificada. El grupo de seguridad debe ser uno que haya creado para la VPC que contenga la subred especificada.
```
$interface1 = New-Object Amazon.EC2.Model.InstanceNetworkInterfaceSpecification
$interface1.DeviceIndex = 0
$interface1.SubnetId = "subnet-b61f49f0"
$interface1.PrivateIpAddress = "10.0.1.5"
$interface1.Groups.Add("sg-5d293231")
Request-EC2SpotInstance `
-SpotPrice 0.007 `
-InstanceCount 1 `
-Type one-time `
-LaunchSpecification_ImageId ami-7527031c `
-LaunchSpecification_InstanceType m1.small `
-Region us-west-2 `
-LaunchSpecification_NetworkInterfaces $interface1
```